閱讀英文

共用方式為


資料表函式

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

建構資料表

名稱 描述
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.FromRowsTable.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 (部分機器翻譯) 的描述。