Table.SelectColumns

構文

Table.SelectColumns(table as table, columns as any, optional missingField as nullable number) as table

バージョン情報

指定した columns だけが含まれる table を返します。

• table:指定のテーブル。
• columns:返されるテーブル table の列の一覧。 返されるテーブルの列の順序は、columns の一覧の順序になります。
• missingField: (任意) 列が存在しない場合の動作。 例: MissingField.UseNull または MissingField.Ignore。

例 1

列 [Name] のみを含めます。

使用方法

Table.SelectColumns(
    Table.FromRecords({
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
        [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
    }),
    "Name"
)

出力

Table.FromRecords({
    [Name = "Bob"],
    [Name = "Jim"],
    [Name = "Paul"],
    [Name = "Ringo"]
})

例 2

列 [CustomerID] と [Name] を含めます。

使用方法

Table.SelectColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    {"CustomerID", "Name"}
)

出力

Table.FromRecords({[CustomerID = 1, Name = "Bob"]})

例 3

付加列が存在しない場合、既定の結果はエラーになります。

使用方法

Table.SelectColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    "NewColumn"
)

出力

[Expression.Error] The field 'NewColumn' of the record wasn't found.

例 4

付加列が存在しない場合、オプション MissingField.UseNull によって、null 値の列が作成されます。

使用方法

Table.SelectColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    {"CustomerID", "NewColumn"},
    MissingField.UseNull
)

出力

Table.FromRecords({[CustomerID = 1, NewColumn = null]})