Table.RenameColumns

ไวยากรณ์

Table.RenameColumns(table as table, renames as list, optional missingField as nullable number) as table

เกี่ยวกับ

ดําเนินการเปลี่ยนชื่อที่กําหนดให้กับคอลัมน์ในตารางtable การดําเนินการ renames แทนที่ประกอบด้วยรายการของสองค่า คือชื่อคอลัมน์เก่าและชื่อคอลัมน์ใหม่ ที่ระบุไว้ในรายการ ถ้าไม่มีคอลัมน์อยู่ ข้อยกเว้นจะแสดงขึ้นมา เว้นแต่ว่าพารามิเตอร์ missingField ที่เลือกได้ จะระบุทางเลือก (เช่นMissingField.UseNull หรือ MissingField.Ignore)

ตัวอย่าง 1

แทนที่ชื่อคอลัมน์ "CustomerNum" ด้วย "CustomerID" ในตาราง

การใช้งาน

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

เอาท์พุท

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

ตัวอย่าง 2

แทนที่ชื่อคอลัมน์ "CustomerNum" ด้วย "CustomerID" และ "PhoneNum" ด้วย "Phone" ในตาราง

การใช้งาน

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

เอาท์พุท

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

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

แทนที่ชื่อคอลัมน์ "NewCol" ด้วย "NewColumn" ในตาราง และละเว้นถ้าไม่มีคอลัมน์อยู่

การใช้งาน

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

เอาท์พุท

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