Table.SelectColumns

Sintassi

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

Informazioni su

Restituisce table contenente solo l'oggetto columns specificato.

• table: tabella specificata.
• columns: elenco di colonne della tabella table da restituire. Le colonne della tabella restituita sono elencate nell'ordine indicato in columns.
• missingField: (Facoltativo) Operazione da eseguire se la colonna non esiste. Esempio: MissingField.UseNull o MissingField.Ignore.

Esempio 1

Includere solo la colonna [Name].

Utilizzo

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

Output

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

Esempio 2

Includere solo le colonne [CustomerID] e [Name].

Utilizzo

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

Output

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

Esempio 3

Se la colonna inclusa non esiste, il risultato predefinito sarà un errore.

Utilizzo

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

Output

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

Esempio 4

Se la colonna inclusa non esiste, l'opzione MissingField.UseNull crea una colonna di valori Null.

Utilizzo

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

Output

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