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