資料表函式
這些函式會建立及操作資料表值。
建構資料表
| 名稱 | 描述 |
|---|---|
| #table | 從數據列和數據行建立數據表值。 |
| 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.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 | 指出數據表是否包含任何數據列。 |
| Table.PartitionValues | 傳回資料表分割方式的相關資訊。 |
| Table.Profile | 傳回資料表資料行的設定檔。 |
| Table.RowCount | 傳回資料表中的行數。 |
| Table.Schema | 傳回數據表，其中包含指定數據表之數據行的描述（也就是架構）。 |
| Tables.GetRelationships | 取得一組數據表之間的關聯性。 |
資料列作業
| 名稱 | 描述 |
|---|---|
| Table.AlternateRows | 保留初始位移，然後交替擷取和略過接下來的數據列。 |
| Table.Combine | 傳回代表資料表清單合併結果的資料表。 |
| Table.FindText | 傳回包含數據表中指定文字的所有數據列。 |
| Table.First | 傳回第一個數據列或指定的預設值。 |
| Table.FirstN | 傳回指定的第一個計數數據列。 |
| Table.FirstValue | 傳回資料表第一個資料列的第一個資料行，或傳回指定的預設值。 |
| Table.FromPartitions | 傳回一個數據表，該數據表是通過合併一組已分區的數據表而獲得的結果。 |
| Table.InsertRows | 將數據列清單插入資料表中指定的位置。 |
| Table.Last | 傳回最後一個數據列或指定的預設值。 |
| Table.LastN | 傳回最後指定的數行。 |
| Table.MatchesAllRows | 指出數據表中的所有數據列是否符合指定的條件。 |
| Table.MatchesAnyRows | 指出數據表中的任何數據列是否符合指定的條件。 |
| Table.Partition | 根據指定的群組和數據行數目，將數據表分割成數據表清單。 |
| Table.Range | 傳回從指定位移開始的數據列。 |
| Table.RemoveFirstN | 傳回資料表，該資料表從第一個資料列開始，將指定數目的資料列從資料表中移除。 |
| Table.RemoveLastN | 傳回資料表，該資料表從最後一個資料列開始，將指定數目的資料列從資料表中移除。 |
| 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 | 假設有一對代表屬性值組的數據行，請將屬性數據行中的數據旋轉成數據行標題。 |
| Table.PrefixColumns | 傳回數據表，其中的欄位都已加上指定文字作為前綴。 |
| Table.PromoteHeaders | 將第一列的數值提升為新的欄標頭（也就是欄位名稱）。 |
| Table.RemoveColumns | 拿掉指定的欄。 |
| Table.ReorderColumns | 傳回具有指定順序之欄位的資料表。 |
| Table.RenameColumns | 傳回資料表，其資料行已依照指定重新命名。 |
| Table.SelectColumns | 只傳回具有指定數據行的數據表。 |
| Table.TransformColumnNames | 使用指定的函式來轉換資料行名稱。 |
| Table.Unpivot | 將數據表中的一組數據行轉譯成屬性值組。 |
| Table.UnpivotOtherColumns | 將指定集合以外的所有數據行轉譯成屬性值組。 |
轉換
| 名稱 | 描述 |
|---|---|
| Table.AddColumn | 加入具有指定名稱的欄位。 值是使用指定的選取函式來計算，而每個數據列都會作為輸入。 |
| Table.AddFuzzyClusterColumn | 新增資料行，其中包含由資料表中所指定資料行模糊分組值所取得的代表值。 |
| Table.AddIndexColumn | 附加具有明確位置值的數據行。 |
| Table.AddJoinColumn | 在提供的數據行上執行數據表之間的聯結，並在新的數據行中產生聯結結果。 |
| Table.AddKey | 將索引鍵新增至數據表。 |
| Table.AggregateTableColumn | 將數據表中的一列彙總至包含表格的多列中。 |
| Table.CombineColumns | 使用指定的結合器函式，將指定的數據行合併成新的數據行。 |
| Table.CombineColumnsToRecord | 將指定的資料行合併成新的記錄值資料行，其中每一筆記錄都有對應至已合併資料行名稱和值的欄位名稱和值。 |
| Table.ConformToPageReader | 這個函式僅供內部使用。 |
| Table.ExpandListColumn | 指定資料表中的清單資料行之後，針對其清單中的每個值建立一個資料列複本。 |
| Table.ExpandRecordColumn | 將記錄之資料行擴充成包含每個值的資料行。 |
| Table.ExpandTableColumn | 將記錄或資料表之資料行擴充成所包含資料表中的多個資料行。 |
| Table.FillDown | 將上一個儲存格的值傳播至數據行中下方的 Null 值儲存格。 |
| Table.FillUp | 將儲存格的值傳播至數據行中上方的 Null 值儲存格。 |
| Table.FilterWithDataTable | 這個函式僅供內部使用。 |
| Table.FuzzyGroup | 根據索引鍵的模糊比對，將數據表中的數據列分組。 |
| Table.FuzzyJoin | 根據所指定索引鍵來聯結兩個資料表中模糊比對的資料列。 |
| Table.FuzzyNestedJoin | 在資料表之間對提供的資料行執行模糊聯結，並在新的資料行中產生聯結結果。 |
| Table.Group | 將數據表中具有相同索引鍵的數據列分組。 |
| Table.Join | 聯結兩個數據表中根據指定鍵相符的數據行。 |
| Table.Keys | 傳回指定資料表的索引鍵。 |
| Table.NestedJoin | 在提供的數據行上執行數據表之間的聯結，並在新的數據行中產生聯結結果。 |
| Table.ReplaceErrorValues | 以相對應的指定值來取代指定資料行中錯誤值。 |
| Table.ReplaceKeys | 取代指定資料表的索引鍵。 |
| Table.ReplaceRelationshipIdentity | 這個函式僅供內部使用。 |
| Table.ReplaceValue | 在指定的列中將一個值替換為另一個值。 |
| Table.Split | 將所指定資料表分割為一組使用特定頁面大小的資料表。 |
| 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.AddRankColumn | 附加一個資料行，並使用一或多個其他資料行進行排名。 |
| Table.Max | 使用指定的準則傳回最大的數據列或預設值。 |
| Table.MaxN | 根據指定的準則傳回最大的資料列或多個資料列。 |
| Table.Min | 使用指定的準則傳回最小數據列或預設值。 |
| Table.MinN | 使用指定的準則返回最小的資料列。 |
| Table.Sort | 使用一或多個數據行名稱和比較準則來排序數據表。 |
その他
| 名稱 | 描述 |
|---|---|
| Table.Buffer | 緩衝記憶體中的數據表，在評估期間將其與外部變更隔離。 |
| Table.StopFolding | 防止對原始數據源執行任何下游作業。 |
參數值
為輸出資料行命名
這個參數是文字值清單，其可指定所產生資料表的資料行名稱。 這個參數通常用於 資料表建構函式，例如 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的描述。