Table.TransformColumns

構文

Table.TransformColumns(table as table, transformOperations as list, optional defaultTransformation as nullable function, optional missingField as nullable number) as table

バージョン情報

パラメーター transformOperations で指定された列に変換操作を適用することで (形式は {列名, 変換})、入力 table からテーブルを返します。 列が存在しない場合は、省略可能なパラメーター defaultTransformation によって代替手段が指定されていない限り、例外がスローされます (例: MissingField.UseNullMissingField.Ignore)。

例 1

列 [A] の数値を数値に変換します。

Table.TransformColumns(
    Table.FromRecords({
        [A = "1", B = 2],
        [A = "5", B = 10]
    }),
    {"A", Number.FromText}
)
A B
1 2
5 10

例 2

存在しない列 [X] の数値をテキスト値に変換します。存在しない列は無視されます。

Table.TransformColumns(
    Table.FromRecords({
        [A = "1", B = 2],
        [A = "5", B = 10]
    }),
    {"X", Number.FromText},
    null,
    MissingField.Ignore
)
A B
1 2
5 10

例 3

存在しない列 [X] の数値をテキスト値に変換します。存在しない列には既定で NULL が設定されます。

Table.TransformColumns(
    Table.FromRecords({
        [A = "1", B = 2],
        [A = "5", B = 10]
    }),
    {"X", Number.FromText},
    null,
    MissingField.UseNull
)
A B X
1 2
5 10

例 4

存在しない列 [X] の数値をテキスト値に変換します。存在しない列にエラーが与えられます。

Table.TransformColumns(
    Table.FromRecords({
        [A = "1", B = 2], 
        [A = "5", B = 10]
    }),
    {"X", Number.FromText}
)

[Expression.Error] The column 'X' of the table wasn't found.