Ler em inglês

Partilhar via


Table.SelectColumns

Sintaxe

Table.SelectColumns(table as table, columns as any, optional missingField as nullable number) as table

Sobre

Devolve o table com apenas o especificado columns.

  • table: A tabela fornecida.
  • columns: A lista de colunas da tabela table a serem retornadas. As colunas na tabela retornada estão na ordem listada em columns.
  • missingField: (Opcional) O que fazer se a coluna não existir. Exemplo: MissingField.UseNull ou MissingField.Ignore.

Exemplo 1

Inclua apenas a coluna [Nome].

Utilização

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"
)

Saída

Table.FromRecords({
    [Name = "Bob"],
    [Name = "Jim"],
    [Name = "Paul"],
    [Name = "Ringo"]
})

Exemplo 2

Inclua apenas as colunas [CustomerID] e [Name].

Utilização

Table.SelectColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    {"CustomerID", "Name"}
)

Saída

Table.FromRecords({[CustomerID = 1, Name = "Bob"]})

Exemplo 3

Se a coluna incluída não existir, o resultado padrão será um erro.

Utilização

Table.SelectColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    "NewColumn"
)

Saída

[Expression.Error] The field 'NewColumn' of the record wasn't found.

Exemplo 4

Se a coluna incluída não existir, a opção MissingField.UseNull criará uma coluna de valores nulos.

Utilização

Table.SelectColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    {"CustomerID", "NewColumn"},
    MissingField.UseNull
)

Saída

Table.FromRecords({[CustomerID = 1, NewColumn = null]})