Table.RenameColumns

構文

Table.RenameColumns(table as table, renames as list, optional missingField as nullable number) as table

バージョン情報

テーブル table で列の名前を指定どおりに変更します。 置換操作 renames は、リストで指定された 2 つの値 (古い列名と新しい列名) で構成されます。 列が存在しない場合、省略可能なパラメーター missingField で代替候補が指定されていない限り、例外がスローされます (例: MissingField.UseNull または MissingField.Ignore)。

例 1

テーブルの列名 "CustomerNum" を "CustomerID" に置き換えます。

使用方法

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

出力

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

例 2

テーブルの列名 "CustomerNum" を "CustomerID" に、列名 "PhoneNum" を "Phone" に置き換えます。

使用方法

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

出力

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

例 3

テーブルの列名 "NewCol" を "NewColumn" に置き換えます。列が存在しない場合は無視します。

使用方法

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

出力

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