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 tabla table que se va a devolver. Las columnas de la tabla devuelta aparecen en el orden indicado en columns.
  • 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]})