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]})