ฟังก์ชันตาราง

ฟังก์ชันเหล่านี้สร้างและจัดการค่าตาราง

การสร้างตาราง

ชื่อ	รายละเอียด
ItemExpression.From	แสดงทรีไวยากรณ์นามธรรม (AST) สําหรับเนื้อความของฟังก์ชัน
ItemExpression.Item	โหนดแผนผังไวยากรณ์นามธรรม (AST) ที่แสดงหน่วยข้อมูลในนิพจน์หน่วยข้อมูล
RowExpression.Column	แสดงแผนผังไวยากรณ์นามธรรม (AST) ที่แสดงการเข้าถึงคอลัมน์ภายในนิพจน์แถว
RowExpression.From	แสดงทรีไวยากรณ์นามธรรม (AST) สําหรับเนื้อความของฟังก์ชัน
RowExpression.Row	โหนดแผนผังไวยากรณ์นามธรรม (AST) ที่แสดงแถวในนิพจน์แถว
Table.FromColumns	แสดงตารางจากรายการที่มีรายการที่ซ้อนกันกับชื่อคอลัมน์และค่า
Table.FromList	แปลงรายการให้เป็นตารางโดยนําฟังก์ชันการแยกที่ระบุไปใช้กับแต่ละข้อมูลในรายการ
Table.FromRecords	แสดงตารางจากรายการระเบียน
Table.FromRows	สร้างตารางจากรายการที่แต่ละองค์ประกอบของรายการเป็นรายการที่มีค่าคอลัมน์สําหรับแถวเดียว
Table.FromValue	แสดงตารางพร้อมคอลัมน์ที่มีค่าหรือรายการของค่าที่ระบุ
Table.FuzzyGroup	จัดกลุ่มแถวของตารางตามการจับคู่ค่าที่ไม่จําเป็นในคอลัมน์ที่ระบุสําหรับแต่ละแถว
Table.FuzzyJoin	รวมแถวจากสองตารางที่จับคู่ไม่เหมาะสมตามคีย์ที่กําหนด
Table.FuzzyNestedJoin	ดําเนินการรวมแบบไม่ลับ (fuzzy join) ระหว่างตารางบนคอลัมน์ที่ให้และสร้างผลลัพธ์การรวมในคอลัมน์ใหม่
Table.Split	แยกตารางที่ระบุออกเป็นรายการของตารางโดยใช้ขนาดหน้าที่ระบุ
Table.WithErrorContext	ฟังก์ชันนี้มีไว้สําหรับการใช้งานภายในเท่านั้น
Table.View	สร้างหรือขยายตารางด้วยตัวจัดการที่ผู้ใช้กําหนดเองสําหรับคิวรีและการดําเนินการ
Table.ViewError	สร้างเรกคอร์ดข้อผิดพลาดที่ปรับเปลี่ยนซึ่งจะไม่ทริกเกอร์การแสดงแทนเมื่อตัวจัดการที่กําหนดไว้ในมุมมอง (ผ่าน Table.View)
Table.ViewFunction	สร้างฟังก์ชันที่ตัวจัดการที่กําหนดในมุมมองสามารถดักข้อมูลได้ (ผ่าน Table.View)

แปลง

ชื่อ	รายละเอียด
Table.ToColumns	แสดงรายการของรายการที่ซ้อนกัน โดยแต่ละรายการแสดงถึงคอลัมน์ของค่าในตารางอินพุต
Table.ToList	ส่งกลับตารางลงในรายการโดยนําฟังก์ชันการรวมที่ระบุไปใช้กับแต่ละแถวของค่าในตาราง
Table.ToRecords	ส่งกลับรายการของเรกคอร์ดจากตารางอินพุต
Table.ToRows	แสดงรายการที่ซ้อนกันของค่าแถวจากตารางอินพุต

ข้อมูล

ชื่อ	รายละเอียด
Table.ApproximateRowCount	ส่งกลับจํานวนแถวโดยประมาณในตาราง
Table.ColumnCount	แสดงจํานวนคอลัมน์ในตาราง
Table.IsEmpty	แสดงค่าเป็น true ถ้าตารางไม่มีแถวใดอยู่เลย
Table.Profile	ส่งกลับโปรไฟล์ของคอลัมน์ของตาราง
Table.RowCount	ส่งกลับจํานวนแถวในตาราง
Table.Schema	แสดงตารางที่มีคําอธิบายของคอลัมน์ (เช่น สคีมา) ของตารางที่ระบุ
Tables.GetRelationships	ส่งกลับความสัมพันธ์ระหว่างชุดตาราง

การดําเนินการของแถว

ชื่อ	รายละเอียด
Table.AlternateRows	แสดงตารางที่มีรูปแบบการสลับของแถวจากตาราง
Table.Combine	แสดงตารางที่เป็นผลลัพธ์ของการผสานรายการตาราง ตารางทั้งหมดต้องมีโครงสร้างชนิดแถวเดียวกัน
Table.FindText	แสดงตารางที่มีเฉพาะแถวที่มีข้อความที่ระบุภายในหนึ่งเซลล์หรือส่วนใดก็ตามดังกล่าว
Table.First	ส่งกลับแถวแรกจากตาราง
Table.FirstN	ส่งกลับแถวแรกของตาราง โดยขึ้นอยู่กับพารามิเตอร์ countOrCondition
Table.FirstValue	ส่งกลับคอลัมน์แรกของแถวแรกของตาราง หรือค่าเริ่มต้นตามที่ระบุไว้
Table.FromPartitions	ส่งกลับตารางที่เป็นผลลัพธ์ของการรวมชุดตารางที่มีการแบ่งพาร์ติชันไว้ในคอลัมน์ใหม่ โดยคุณสามารถเลือกระบุชนิดของคอลัมน์ได้ ค่าเริ่มต้นคือ ใด ๆ
Table.InsertRows	ส่งกลับตารางที่มีรายการแถวที่แทรกลงในตารางที่ดัชนี แต่ละแถวที่จะแทรกต้องตรงกับชนิดแถวของตาราง
Table.Last	ส่งกลับแถวสุดท้ายของตาราง
Table.LastN	ส่งกลับแถวสุดท้ายจากตาราง โดยขึ้นอยู่กับพารามิเตอร์ countOrCondition
Table.MatchesAllRows	ส่งกลับเป็น true ถ้าแถวทั้งหมดในตารางตรงกับเงื่อนไข
Table.MatchesAnyRows	ส่งกลับเป็น true ถ้าแถวใด แถวหนึ่งในตารางตรงกับเงื่อนไข
Table.Partition	แบ่งพาร์ติชันของตารางออกเป็นรายการของจํานวนกลุ่มของตาราง โดยยึดตามค่าของคอลัมน์ของแต่ละแถวและฟังก์ชันแฮช ฟังก์ชันแฮชจะใช้กับค่าของคอลัมน์ของแถวเพื่อรับค่าแฮชสําหรับแถวนั้น กลุ่มมอดุโลของค่าแฮชจะกําหนดว่าจะวางแถวใดในตารางที่แสดง
Table.PartitionValues	ส่งกลับข้อมูลเกี่ยวกับวิธีการแบ่งพาร์ติชันตาราง
Table.Range	ส่งกลับจํานวนแถวที่ระบุจากตารางที่เริ่มต้นที่ออฟเซต
Table.RemoveFirstN	ส่งกลับตารางที่มีจํานวนแถวที่ระบุ ซึ่งถูกเอาออกจากตารางที่เริ่มต้นจากแถวแรก จํานวนแถวที่ลบออกจะขึ้นอยู่กับพารามิเตอร์ countOrCondition ที่เลือกได้
Table.RemoveLastN	ส่งกลับตารางที่มีจํานวนแถวที่ระบุ ซึ่งถูกเอาออกจากตารางที่เริ่มต้นจากแถวสุดท้าย จํานวนแถวที่ลบออกจะขึ้นอยู่กับพารามิเตอร์ countOrCondition ที่เลือกได้
Table.RemoveRows	ส่งกลับตารางที่มีจํานวนแถวที่ระบุ ซึ่งถูกเอาออกจากตารางที่เริ่มต้นจากค่าชดเชย
Table.RemoveRowsWithErrors	ส่งกลับตารางที่มีแถวทั้งหมด ซึ่งถูกเอาออกจากตารางที่มีข้อผิดพลาดในเซลล์อย่างน้อยหนึ่งเซลล์ในหนึ่งแถว
Table.Repeat	ส่งกลับตารางที่มีแถวของตารางซ้ําตามจํานวนครั้ง
Table.ReplaceRows	ส่งกลับตารางที่แถวเริ่มต้นจากค่าชดเชยและนับต่อเนื่องจะถูกแทนที่ด้วยแถวที่ให้ไว้
Table.ReverseRows	ส่งกลับตารางที่มีแถวในลําดับย้อนกลับ
Table.SelectRows	ส่งกลับตารางที่มีเฉพาะแถวที่ตรงกับเงื่อนไข
Table.SelectRowsWithErrors	ส่งกลับตารางที่มีเฉพาะแถวจากตารางที่มีข้อผิดพลาดในเซลล์อย่างน้อยหนึ่งเซลล์ในหนึ่งแถว
Table.SingleRow	ส่งกลับแถวเดียวจากตาราง
Table.Skip	ส่งกลับตารางที่ไม่มีแถวแรกหรือแถวแรกของตาราง
Table.SplitAt	แสดงรายการที่มีแถวจํานวนแรกที่ระบุและแถวที่เหลือ

การดําเนินการคอลัมน์

ชื่อ	รายละเอียด
Table.Column	ส่งกลับค่าจากคอลัมน์ในตาราง
Table.ColumnNames	ส่งกลับชื่อของคอลัมน์จากตาราง
Table.ColumnsOfType	แสดงรายการที่มีชื่อของคอลัมน์ที่ตรงกับชนิดที่ระบุ
Table.DemoteHeaders	ลดระดับแถวส่วนหัวลงไปเป็นแถวแรกของตาราง
Table.DuplicateColumn	ทําซ้ําคอลัมน์ที่มีชื่อที่ระบุ ค่าและชนิดจะถูกคัดลอกจากคอลัมน์ต้นทาง
Table.HasColumns	ระบุว่าตารางมีคอลัมน์ที่ระบุหรือไม่
Table.Pivot	กําหนดตารางและแอตทริบิวต์คอลัมน์ที่มี pivotValues สร้างคอลัมน์ใหม่สําหรับแต่ละค่า pivot และกําหนดค่าเหล่านั้นจาก valueColumn สามารถจัดเตรียม aggregationFunction ที่เลือกได้เพื่อจัดการการปรากฏหลายครั้งของค่าคีย์เดียวกันในคอลัมน์แอตทริบิวต์
Table.PrefixColumns	ส่งกลับตารางที่คอลัมน์ทั้งหมดนําหน้าด้วยค่าข้อความ
Table.PromoteHeaders	เลื่อนระดับแถวแรกของตารางไปยังส่วนหัวหรือชื่อคอลัมน์ของตาราง
Table.RemoveColumns	ส่งกลับตารางที่ไม่มีคอลัมน์หรือคอลัมน์ที่ระบุ
Table.ReorderColumns	ส่งกลับตารางที่มีคอลัมน์ที่ระบุตามลําดับที่สัมพันธ์กับอีกคอลัมน์หนึ่ง
Table.RenameColumns	ส่งกลับตารางที่มีคอลัมน์ที่เปลี่ยนชื่อตามที่ระบุ
Table.SelectColumns	ส่งกลับตารางที่มีเฉพาะคอลัมน์ที่ระบุเท่านั้น
Table.TransformColumnNames	แปลงชื่อคอลัมน์โดยใช้ฟังก์ชันที่กําหนด
Table.Unpivot	กําหนดรายการคอลัมน์ตาราง แปลงคอลัมน์เหล่านั้นเป็นคู่ของค่าแอตทริบิวต์
Table.UnpivotOtherColumns	แปลคอลัมน์ทั้งหมดนอกเหนือจากชุดที่ระบุเป็นคู่ของค่าแอตทริบิวต์ รวมกับค่าที่เหลือในแต่ละแถว

การแปลงข้อมูล

ชื่อ	รายละเอียด
Table.AddColumn	เพิ่มคอลัมน์ที่ชื่อ newColumnName ลงในตาราง
Table.AddFuzzyClusterColumn	เพิ่มคอลัมน์ใหม่ด้วยค่าตัวแทนที่ได้รับจากค่าการจัดกลุ่มแบบไม่ลับของคอลัมน์ที่ระบุในตาราง
Table.AddIndexColumn	ส่งกลับตารางที่มีคอลัมน์ใหม่ที่มีชื่อเฉพาะเจาะจงสําหรับแต่ละแถว ซึ่งประกอบด้วยดัชนีของแถวในตาราง
Table.AddJoinColumn	ดําเนินการรวมแบบซ้อนกันระหว่าง table1 และ table2 จากคอลัมน์ที่ระบุ และสร้างผลลัพธ์การรวมเป็นคอลัมน์ newColumnName สําหรับแต่ละแถวของ table1
Table.AddKey	เพิ่มคีย์ลงในตาราง
Table.AggregateTableColumn	รวมตารางที่ซ้อนกันในคอลัมน์ที่ระบุลงในหลายคอลัมน์ที่มีค่ารวมสําหรับตารางเหล่านั้น
Table.CombineColumns	Table.CombineColumns ผสานคอลัมน์โดยใช้ฟังก์ชัน combiner เพื่อสร้างคอลัมน์ใหม่ Table.CombineColumns เป็นค่าผกผันของ Table.SplitColumns
Table.CombineColumnsToRecord	รวมคอลัมน์ที่ระบุลงในคอลัมน์ที่มีค่าระเบียนใหม่ โดยแต่ละระเบียนมีชื่อเขตข้อมูลและค่าที่สอดคล้องกับชื่อคอลัมน์และค่าของคอลัมน์ที่รวมเข้าด้วยกัน
Table.ConformToPageReader	ฟังก์ชันนี้มีไว้สําหรับการใช้งานภายในเท่านั้น
Table.ExpandListColumn	สร้างสําเนาของแถวสําหรับแต่ละค่าในรายการ โดยกําหนดคอลัมน์ของรายการในตาราง
Table.ExpandRecordColumn	ขยายคอลัมน์ของระเบียนลงในคอลัมน์ที่มีค่าแต่ละค่า
Table.ExpandTableColumn	ขยายคอลัมน์ของเรกคอร์ดหรือคอลัมน์ของตารางลงในหลายคอลัมน์ในตารางที่มี
Table.FillDown	แทนที่ค่า null ในคอลัมน์หรือคอลัมน์ที่ระบุของตารางด้วยค่าที่ไม่ใช่ null ล่าสุดในคอลัมน์
Table.FillUp	ส่งกลับตารางจากตารางที่ระบุซึ่งมีการเผยแพร่ค่าของเซลล์ถัดไปไปยังเซลล์ที่มีค่า Null ด้านบนคอลัมน์ที่ระบุ
Table.FilterWithDataTable	ฟังก์ชันนี้มีไว้สําหรับการใช้งานภายในเท่านั้น
Table.Group	จัดกลุ่มแถวของตารางตามค่าของคอลัมน์คีย์สําหรับแต่ละแถว
Table.Join	รวมแถวของ table1 กับแถวของ table2 โดยยึดตามความเท่าเทียมกันของค่าของคอลัมน์คีย์ที่เลือกโดย table1, key1 และ table2, key2
Table.Keys	ส่งกลับคีย์ของตารางที่ระบุ
Table.NestedJoin	รวมแถวของตารางโดยยึดตามความเท่าเทียมกันของคีย์ ผลลัพธ์จะถูกป้อนลงในคอลัมน์ใหม่
Table.ReplaceErrorValues	แทนที่ค่าที่ผิดพลาดในคอลัมน์ที่ระบุด้วยค่าที่สอดคล้องกันซึ่งระบุไว้
Table.ReplaceKeys	แทนที่คีย์ของตารางที่ระบุ
Table.ReplaceRelationshipIdentity	ฟังก์ชันนี้มีไว้สําหรับการใช้งานภายในเท่านั้น
Table.ReplaceValue	แทนที่ oldValue ด้วย newValue ในคอลัมน์เฉพาะของตาราง โดยใช้ฟังก์ชันตัวแทนที่จัดให้มา เช่น ข้อความ แทนที่ หรือ Value.Replace
Table.SplitColumn	ส่งกลับชุดคอลัมน์ใหม่จากคอลัมน์เดียวที่ใช้ฟังก์ชันตัวแยกสําหรับแต่ละค่า
Table.TransformColumns	แปลงค่าของคอลัมน์อย่างน้อยหนึ่งคอลัมน์
Table.TransformColumnTypes	แปลงชนิดคอลัมน์จากตารางโดยใช้ชนิด
Table.TransformRows	แปลงแถวจากตารางโดยใช้ฟังก์ชันการแปลง
Table.Transpose	ส่งกลับตารางที่มีการแปลงคอลัมน์เป็นแถวและแถวเป็นคอลัมน์จากตารางอินพุต

สมาชิก

ชื่อ	รายละเอียด
Table.Contains	พิจารณาว่าเรกคอร์ดปรากฏเป็นแถวในตารางหรือไม่
Table.ContainsAll	พิจารณาว่าเรกคอร์ดที่ระบุทั้งหมดปรากฏเป็นแถวในตารางหรือไม่
Table.ContainsAny	พิจารณาว่าเรกคอร์ดใดเรกคอร์ดหนึ่งที่ระบุปรากฏเป็นแถวในตารางหรือไม่
Table.Distinct	ลบแถวที่ซ้ํากันออกจากตารางเพื่อให้แน่ใจว่าแถวที่เหลือทั้งหมดนั้นแตกต่างกัน
Table.IsDistinct	พิจารณาว่าตารางมีเฉพาะแถวที่แตกต่างกันหรือไม่
Table.PositionOf	กําหนดตําแหน่งหรือตําแหน่งของแถวภายในตาราง
Table.PositionOfAny	พิจารณาว่าหนึ่งตําแหน่งหรือหลายตําแหน่งของแถวที่ระบุแถวใดแถวหนึ่งอยู่ภายในตารางหรือไม่
Table.RemoveMatchingRows	ลบแถวที่เกิดขึ้นทั้งหมดออกจากตาราง
Table.ReplaceMatchingRows	แทนที่แถวเฉพาะจากตารางด้วยแถวใหม่

การสั่งซื้อ

ชื่อ	รายละเอียด
Table.Max	ส่งกลับแถวที่ใหญ่ที่สุดหรือหลายแถวจากตารางโดยใช้ ComparCriteria
Table.MaxN	ส่งกลับแถวที่ใหญ่ที่สุด N แถวจากตาราง หลังจากเรียงลําดับแถวแล้ว จะต้องมีการระบุพารามิเตอร์ countOrCondition เพื่อกรองผลลัพธ์เพิ่มเติม
Table.Min	ส่งกลับแถวที่เล็กที่สุดหรือหลายแถวจากตารางโดยใช้ ComparCriteria
Table.MinN	ส่งกลับแถวที่เล็กที่สุด N แถวในตารางที่กําหนด หลังจากเรียงลําดับแถวแล้ว จะต้องมีการระบุพารามิเตอร์ countOrCondition เพื่อกรองผลลัพธ์เพิ่มเติม
Table.AddRankColumn	ผนวกคอลัมน์ที่มีการจัดอันดับของคอลัมน์อื่นอย่างน้อยหนึ่งคอลัมน์
Table.Sort	เรียงลําดับแถวในตารางโดยใช้ comparisonCriteria หรือการเรียงลําดับเริ่มต้นหากไม่ได้ระบุไว้

อื่นๆ

ชื่อ	รายละเอียด
Table.Buffer	บัฟเฟอร์ตารางลงในหน่วยความจํา โดยแยกตารางออกจากการเปลี่ยนแปลงภายนอกระหว่างการประเมิน

ค่าพารามิเตอร์ต่างๆ

การตั้งชื่อคอลัมน์เอาต์พุต

พารามิเตอร์นี้เป็นรายการของค่าข้อความที่ระบุชื่อคอลัมน์ของตารางผลลัพธ์ โดยทั่วไปพารามิเตอร์นี้จะใช้ในฟังก์ชันการสร้างตาราง เช่น Table.FromRows และ Table.FromList

เกณฑ์การเปรียบเทียบ

เกณฑ์การเปรียบเทียบสามารถระบุเป็นค่าใดค่าหนึ่งต่อไปนี้:

• ค่าตัวเลขเพื่อระบุลําดับการจัดเรียง ข้อมูลเพิ่มเติม: ลําดับการจัดเรียง

• หากต้องการคํานวณคีย์ที่จะใช้สําหรับการเรียงลําดับ ฟังก์ชันของอาร์กิวเมนต์หนึ่งรายการสามารถใช้ได้

• เมื่อต้องการเลือกคีย์และลําดับการควบคุม เกณฑ์การเปรียบเทียบสามารถเป็นรายการที่มีคีย์และลําดับได้

• เพื่อควบคุมการเปรียบเทียบทั้งหมด ฟังก์ชันของสองอาร์กิวเมนต์สามารถใช้ที่ส่งกลับเป็นค่า -1, 0 หรือ 1 ตามความสัมพันธ์ระหว่างอินพุตด้านซ้ายและขวา Value.Compare สามารถใช้เพื่อกําหนดตรรกะนี้

ตัวอย่างเช่น ไปที่คําอธิบายของ Table.Sort

เกณฑ์การนับหรือเงื่อนไข

โดยทั่วไปเกณฑ์นี้จะใช้ในการเรียงลําดับหรือการดําเนินการของแถว ซึ่งเป็นตัวกําหนดจํานวนแถวที่ส่งกลับในตาราง และสามารถใช้สองฟอร์ม หนึ่งตัวเลข หรือหนึ่งเงื่อนไข

• ตัวเลขแสดงจํานวนค่าที่จะส่งกลับแบบอินไลน์ด้วยฟังก์ชันที่เหมาะสม

• ถ้ามีการระบุเงื่อนไข แถวที่มีค่าที่ตรงตามเงื่อนไขในเบื้องต้นจะแสดงขึ้นมา หากค่าไม่เป็นไปตามเงื่อนไข จะไม่มีการพิจารณาค่าเพิ่มเติม

ข้อมูลเพิ่มเติม: Table.FirstN, Table.MaxN

การจัดการค่าพิเศษ

ค่าเพิ่มเติมจะใช้เพื่อระบุว่าฟังก์ชันควรจัดการกับค่าพิเศษในแถวอย่างไร มีการระบุพารามิเตอร์นี้เป็นตัวเลข ซึ่งแมปไปยังตัวเลือกต่อไปนี้:

ExtraValues.List = 0 ExtraValues.Error = 1 ExtraValues.Ignore = 2

ข้อมูลเพิ่มเติม: Table.FromList, ExtraValues.Type

การจัดการคอลัมน์ที่ขาดหายไป

พารามิเตอร์นี้ถูกใช้เพื่อระบุว่าฟังก์ชันควรจัดการกับคอลัมน์ที่ขาดหายไปอย่างไร มีการระบุพารามิเตอร์นี้เป็นตัวเลข ซึ่งแมปไปยังตัวเลือกต่อไปนี้:

MissingField.Error = 0 MissingField.Ignore = 1 MissingField.UseNull = 2;

พารามิเตอร์นี้ถูกใช้ในคอลัมน์หรือการดําเนินการแปลง ตัวอย่างเช่น ใน Table.TransformColumns ข้อมูลเพิ่มเติม: MissingField.Type

ลำดับการจัดเรียง

การเรียงลําดับจะใช้เพื่อระบุวิธีการเรียงลําดับผลลัพธ์ มีการระบุพารามิเตอร์นี้เป็นตัวเลข ซึ่งแมปไปยังตัวเลือกต่อไปนี้:

Order.Ascending = 0 Order.Descending = 1

ข้อมูลเพิ่มเติม: Order.Type

เกณฑ์สมการ

เกณฑ์สมการสําหรับตารางสามารถระบุเป็นอย่างใดอย่างหนึ่ง:

• ค่าฟังก์ชันที่เป็นอย่างใดอย่างหนึ่ง:

  • ตัวเลือกหลักที่กําหนดคอลัมน์ในตารางเพื่อใช้เกณฑ์ความเท่าเทียมกัน

  • ฟังก์ชันตัวเปรียบเทียบที่ใช้ในการระบุชนิดของการเปรียบเทียบที่จะนําไปใช้ สามารถระบุฟังก์ชันตัวเปรียบเทียบที่มีอยู่ภายในได้ ข้อมูลเพิ่มเติม: ฟังก์ชันตัวเปรียบเทียบ

• รายการของคอลัมน์ในตารางเพื่อใช้เกณฑ์ความเท่าเทียมกัน

ตัวอย่างเช่น ไปที่คําอธิบายของ Table.Distinct