資料表函式

文章
10/05/2023

這些函式會建立及操作資料表值。

建構資料表

名稱	描述
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	在資料表之間對提供的資料行執行模糊聯結，並在新的資料行中產生聯結結果。
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	傳回資料表，該資料表是將一組已分割資料表合併成新資料行的結果。可以選擇性地指定資料行的類型，預設為 any。
Table.InsertRows	傳回資料表，其包含在索引處插入資料表的資料列清單。要插入的每個資料列都必須符合資料表資料列類型。
Table.Last	傳回資料表的最後一個資料列。
Table.LastN	視 countOrCondition 參數而定，傳回資料表的最後一或多個資料列。
Table.MatchesAllRows	如果資料表中的所有資料列都符合條件，則會傳回 true。
Table.MatchesAnyRows	如果資料表中的任一資料列符合條件，則會傳回 true。
Table.Partition	根據每個資料列的資料行值和雜湊函式，將資料表分割成 groups 個資料表的清單。雜湊函式會套用至資料列的資料行值，以取得該資料列的雜湊值。雜湊值模數 groups 會決定要將該資料列放入哪些傳回的資料表。
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 的屬性資料行之後，針對每個樞紐值建立新的資料行，並從 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 之間的巢狀聯結，並產生聯結結果作為 table1 中每個資料列的 newColumnName 資料行。
Table.AddKey	將索引鍵新增至資料表。
Table.AggregateTableColumn	將巢狀內嵌在特定資料行中的資料表，巢總成包含這些資料表巢總值的多個資料行。
Table.CombineColumns	Table.CombineColumns 會使用結合子函式來合併資料行，以產生新的資料行。 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 (key1) 和 table2 (key2) 所選取索引鍵資料行的值是否相等，以聯結 table1 與 table2 的資料列。
Table.Keys	傳回指定資料表的索引鍵。
Table.NestedJoin	根據索引鍵是否相等來聯結資料表的資料列。結果會輸入至新的資料行中。
Table.ReplaceErrorValues	以相對應的指定值來取代指定資料行中錯誤值。
Table.ReplaceKeys	取代指定資料表的索引鍵。
Table.ReplaceRelationshipIdentity	這個函式僅供內部使用。
Table.ReplaceValue	使用所提供的取代子函式 (例如 text.Replace 或 Value.Replace)，以 newValue 取代資料表特定資料行中的 oldValue。
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	使用 comparisonCriteria 傳回資料表中最大的一或多個資料列。
Table.MaxN	傳回資料表中最大的 N 個資料列。在排序資料列之後，必須指定 countOrCondition 參數才能進一步篩選結果。
Table.Min	使用 comparisonCriteria 傳回資料表中最小的一或多個資料列。
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 (部分機器翻譯) 的描述。

分享方式：