Table.SelectColumns
Zwraca tabelę zawierającą tylko określone kolumny.
Syntax
Table.SelectColumns(
table as table,
columns as any,
optional missingField as MissingField.Type
) as table
Remarks
Zwraca tabelę table
zawierającą tylko określone kolumny columns
.
table
: Podana tabela.columns
: Lista kolumn z tabelitable
, które mają zostać zwrócone. Kolumny w zwracanej tabeli mają kolejność określoną w parametrzecolumns
.missingField
: (Opcjonalnie) Co zrobić, jeśli kolumna nie istnieje. Przykład:MissingField.UseNull
lubMissingField.Ignore
.
Examples
Example #1
Uwzględniaj tylko kolumnę [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"
)
Result:
Table.FromRecords({
[Name = "Bob"],
[Name = "Jim"],
[Name = "Paul"],
[Name = "Ringo"]
})
Example #2
Uwzględniaj tylko kolumny [CustomerID] i [Name].
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "Name"}
)
Result:
Table.FromRecords({[CustomerID = 1, Name = "Bob"]})
Example #3
Jeśli uwzględniona kolumna nie istnieje, domyślnym wynikiem jest błąd.
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
"NewColumn"
)
Result:
[Expression.Error] The field 'NewColumn' of the record wasn't found.
Example #4
Jeśli dołączona kolumna nie zostanie zamknięta, opcja <code>MissingField.UseNull</code> utworzy kolumnę wartości null.
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "NewColumn"},
MissingField.UseNull
)
Result:
Table.FromRecords({[CustomerID = 1, NewColumn = null]})
Category
Table.Column operations