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