Table.SelectColumns

Σύνταξη

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

Πληροφορίες

Επιστρέφει το table μόνο με το καθορισμένο columns.

• table: Ο παρεχόμενος πίνακας.
• columns: Η λίστα στηλών από τον πίνακα table προς επιστροφή. Οι στήλες στον πίνακα που επιστρέφεται είναι με τη σειρά που παρατίθεται στο columns.
• missingField: (Προαιρετικό) Τι πρέπει να κάνετε εάν δεν υπάρχει η στήλη. Παράδειγμα: MissingField.UseNull ή MissingField.Ignore.

Παράδειγμα 1

Συμπερίληψη μόνο της στήλης [Name].

Χρήση

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

Έξοδος

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

Παράδειγμα 2

Συμπερίληψη μόνο των στηλών [CustomerID] και [Name].

Χρήση

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

Έξοδος

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

Παράδειγμα 3

Εάν η συμπεριλαμβανόμενη στήλη δεν υπάρχει, το προεπιλεγμένο αποτέλεσμα είναι σφάλμα.

Χρήση

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

Έξοδος

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

Παράδειγμα 4

Εάν η συμπεριλαμβανόμενη στήλη δεν υπάρχει, η επιλογή MissingField.UseNull δημιουργεί μια στήλη τιμών null.

Χρήση

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

Έξοδος

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