Table.PromoteHeaders

ไวยากรณ์

Table.PromoteHeaders(table as table, optional options as nullable record) as table

เกี่ยวกับ

เลื่อนระดับแถวแรกของค่าเป็นส่วนหัวของคอลัมน์ใหม่ (เช่น ชื่อคอลัมน์) ตามค่าเริ่มต้น ค่าข้อความหรือตัวเลขเท่านั้นที่ได้รับการเลื่อนไปยังส่วนหัว ตัวเลือกที่ถูกต้อง:

• PromoteAllScalars: ถ้าตั้งค่าเป็น trueค่าสเกลาทั้งหมดในแถวแรกจะได้รับการเลื่อนระดับไปยังส่วนหัวโดยใช้ Cultureถ้ามีการระบุ (หรือตําแหน่งที่ตั้งเอกสารปัจจุบัน) สําหรับค่าที่ไม่สามารถแปลงเป็นข้อความได้ จะมีการใช้ชื่อคอลัมน์เริ่มต้น
• Culture: ชื่อวัฒนธรรมที่ระบุวัฒนธรรมสําหรับข้อมูล

ตัวอย่างที่ 1

เลื่อนระดับแถวแรกของค่าในตาราง

การใช้งาน

Table.PromoteHeaders(
    Table.FromRecords({
        [Column1 = "CustomerID", Column2 = "Name", Column3 = #date(1980, 1, 1)],
        [Column1 = 1, Column2 = "Bob", Column3 = #date(1980, 1, 1)]
    })
)

เอาท์พุท

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

ตัวอย่าง 2

เลื่อนระดับสเกลาทั้งหมดในแถวแรกของตารางเป็นส่วนหัว

การใช้งาน

Table.PromoteHeaders(
    Table.FromRecords({
        [Rank = 1, Name = "Name", Date = #date(1980, 1, 1)],
        [Rank = 1, Name = "Bob", Date = #date(1980, 1, 1)]}
    ),
    [PromoteAllScalars = true, Culture = "en-US"]
)

เอาท์พุท

Table.FromRecords({[1 = 1, Name = "Bob", #"1/1/1980" = #date(1980, 1, 1)]})