Table.SelectColumns
Sintaxis
Table.SelectColumns(table as table, columns as any, optional missingField as nullable number) as table
Acerca de
Devuelve el elemento table
con únicamente el valor columns
especificado.
table
: la tabla proporcionada.columns
: lista de columnas de la tablatable
que se va a devolver. Las columnas de la tabla devuelta aparecen en el orden indicado encolumns
.missingField
: (Opcional) Qué hacer si la columna no existe. Ejemplo: MissingField.UseNull o MissingField.Ignore.
Ejemplo 1
Incluir solo la columna [Name].
Uso
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"
)
Salida
Table.FromRecords({
[Name = "Bob"],
[Name = "Jim"],
[Name = "Paul"],
[Name = "Ringo"]
})
Ejemplo 2
Incluir solo las columnas [CustomerID] y [Name].
Uso
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "Name"}
)
Salida
Table.FromRecords({[CustomerID = 1, Name = "Bob"]})
Ejemplo 3
Si la columna incluida no existe, el resultado predeterminado será un error.
Uso
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
"NewColumn"
)
Salida
[Expression.Error] The field 'NewColumn' of the record wasn't found.
Ejemplo 4
Si la columna incluida no existe, la opción MissingField.UseNull
crea una columna de valores NULL.
Uso
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "NewColumn"},
MissingField.UseNull
)
Salida
Table.FromRecords({[CustomerID = 1, NewColumn = null]})