資料表函式
這些函式會建立及操作資料表值。
建構資料表
| 名稱 | 描述 |
|---|---|
| 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 (部分機器翻譯) 的描述。