Type.ReplaceTableKeys

構文

Type.ReplaceTableKeys(tableType as type, keys as list) as type

バージョン情報

指定した一連のキーにすべてのキーを置き換えた新しいテーブル型が返されます。

各キーは、次の形式のレコードを使用して定義されます。

• Columns: キーを定義する列名の一覧
• Primary: キーがテーブルの主キーである場合は true、それ以外の場合は false

指定したキーの一覧は検証され、複数の主キーが定義されておらず、すべてのキー列の名前がテーブル型に存在することが確認されます。

例 1

テーブル型のキー情報を置き換えます。

使用方法

let
    BaseType = type table [ID = number, FirstName = text, LastName = text],
    KeysAdded = Type.ReplaceTableKeys(
        BaseType, 
        {
            [Columns = {"ID"}, Primary = true],
            [Columns = {"FirstName", "LastName"}, Primary = false]
        }
    ),
    DetailsOfKeys = Type.TableKeys(KeysAdded)
in
    DetailsOfKeys

出力

{
    [Columns = {"ID"}, Primary = true],
    [Columns = {"FirstName", "LastName"}, Primary = false]
}

例 2

テーブル型に対して以前に定義したキー情報をクリアします。

使用方法

let
    TypeWithKey = Type.AddTableKey(type table [ID = number, Name = text], {"ID"}, true),
    KeyRemoved = Type.ReplaceTableKeys(TypeWithKey, {}),
    DetailsOfKeys = Type.TableKeys(KeyRemoved)
in
    DetailsOfKeys

出力

{}