Table.SelectColumns
Sintaks
Table.SelectColumns(table as table, columns as any, optional missingField as nullable number) as table
Tentang
Mengembalikan table
dengan hanya yang ditentukan columns
.
-
table
: Tabel yang disediakan. -
columns
: Daftar kolom dari tabeltable
yang akan dikembalikan. Kolom dalam tabel yang dikembalikan berada dalam urutan yang tercantum dalamcolumns
. -
missingField
: (Opsional) Apa yang harus dilakukan jika kolom tidak ada. Contoh: MissingField.UseNull atau MissingField.Ignore.
Contoh 1
Hanya sertakan kolom [Nama].
Penggunaan
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"
)
Hasil
Table.FromRecords({
[Name = "Bob"],
[Name = "Jim"],
[Name = "Paul"],
[Name = "Ringo"]
})
Contoh 2
Hanya menyertakan kolom [CustomerID] dan [Nama].
Penggunaan
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "Name"}
)
Hasil
Table.FromRecords({[CustomerID = 1, Name = "Bob"]})
Contoh 3
Jika kolom yang disertakan tidak ada, hasil defaultnya adalah kesalahan.
Penggunaan
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
"NewColumn"
)
Hasil
[Expression.Error] The field 'NewColumn' of the record wasn't found.
Contoh 4
Jika kolom yang disertakan tidak ada, opsi MissingField.UseNull
membuat kolom nilai null.
Penggunaan
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "NewColumn"},
MissingField.UseNull
)
Hasil
Table.FromRecords({[CustomerID = 1, NewColumn = null]})