La función Table.SelectColumns devuelve un subconjunto de columnas de una tabla.
Table.SelectColumns(
table as table,
columns as any,
optional missingField as nullable number
) as table
- table: tabla de la que extraer un subconjunto de columnas
- columns: columnas a extraer
- missingField: (opcional) criterio a seguir cuando se indiquen nombres de campos inexistentes
Si alguno de los nombres de campos no existe, la función devuelve un error salvo que se incluya el parámetro missingField. Éste puede tomar los valores MissingField.Error, MissingField.UseNull o MissingField.Ignore.
En el caso de que se use el valor MissingField.UseNull, la columna inexistente se crea y se rellena con valores nulos.
Podemos extraer dos de las tres columnas de la tabla de este ejemplo con el siguiente código:
let
table = Table.FromRecords(
{
[id = 15, name = "John", country = "USA"],
[id = 21, name = "Alfonso", country = "Japan"],
[id = 33, name = "Marta", country = "Portugal"]
}
)
in
Table.SelectColumns(
table,
{"name", "country"}
)
Si alguno de los nombres de columna no existe y se utiliza como tercer argumento el valor MissingField.UseNull, la columna inexistente se crea y se rellena con valores nulos:
let
table = Table.FromRecords(
{
[id = 15, name = "John", country = "USA"],
[id = 21, name = "Alfonso", country = "Japan"],
[id = 33, name = "Marta", country = "Portugal"]
}
)
in
Table.SelectColumns(
table,
{"name", "city"},
MissingField.UseNull
)
