英語で読む

次の方法で共有


テーブル関数

これらの関数を使用すると、テーブル値の作成と操作を行えます。

テーブルの構築

名前 Description
ItemExpression.From 関数の本文の抽象構文ツリー (AST) を返します。
ItemExpression.Item item 式の item を表す抽象構文ツリー (AST) ノード。
RowExpression.Column row 式内の行の列へのアクセスを表す抽象構文ツリー (AST) を返します。
RowExpression.From 関数の本文の抽象構文ツリー (AST) を返します。
RowExpression.Row row 式の行を表す抽象構文ツリー (AST) ノード。
Table.FromColumns 列の名前と値を持つ入れ子になったリストを含むリストから、テーブルが返されます。
Table.FromList 指定された分割関数をリストの各項目に適用してリストをテーブルに変換します。
Table.FromRecords レコードのリストからテーブルが返されます。
Table.FromRows リストからテーブルが作成されます。リストの各要素は、1 つの行の列値を含むリストです。
Table.FromValue 指定された値または値のリストが含まれる列を含むテーブルが返されます。
Table.FuzzyGroup テーブルの、指定された列の値があいまい一致する行をグループ化します。
Table.FuzzyJoin 指定されたキーに基づいて、2 つのテーブルのあいまい一致する行を結合します。
Table.FuzzyNestedJoin 指定された列についてテーブル間のあいまい結合を実行し、結合の結果を新しい列に生成します。
Table.Split 指定されたテーブルを、指定されたページ サイズを使用してテーブルのリストに分割します。
Table.WithErrorContext この関数は、内部での使用のみを意図しています。
Table.View ユーザー定義のハンドラーを使用して、クエリ処理およびアクション処理用にテーブルを作成または拡張します。
Table.ViewError ビュー (Table.View を使用) で定義されたハンドラーからスローされた場合にフォールバックをトリガーしない、変更されたエラー レコードを作成します。
Table.ViewFunction ビューで (Table.View を使用) 定義されたハンドラーによりインターセプトすることのできる関数を作成します。

コンバージョン

名前 Description
Table.ToColumns それぞれが入力テーブル内の値の列を表す入れ子になったリストのリストが返されます。
Table.ToList 指定された結合関数をテーブルの各行の値に適用することで、テーブルをリストにして返します。
Table.ToRecords 入力テーブルからレコードのリストが返されます。
Table.ToRows 入力テーブルから行の値の入れ子になったリストが返されます。

Information

名前 説明
Table.ApproximateRowCount テーブル内の行の概数を返します。
Table.ColumnCount テーブル内の列の数が返されます。
Table.IsEmpty テーブルに行が含まれていない場合、true が返されます。
Table.Profile テーブルの列のプロファイルが返されます。
Table.RowCount テーブルの行数が返されます。
Table.Schema 指定したテーブルの列の説明 (つまりスキーマ) を含むテーブルが返されます。
Tables.GetRelationships テーブルのセット間のリレーションシップが返されます。

行の操作

名前 Description
Table.AlternateRows テーブルの行の交互のパターンを含むテーブルが返されます。
Table.Combine テーブルのリストをマージした結果であるテーブルが返されます。 テーブルの行の型の構造はすべて同じである必要があります。
Table.FindText 指定されたテキストがセルのいずれかまたはその一部に含まれる行のみを含むテーブルが返されます。
Table.First テーブルから最初の行が返されます。
Table.FirstN countOrCondition パラメーターに応じて、テーブルの最初の行 (1 行または複数行) が返されます。
Table.FirstValue テーブルの先頭行の先頭列、または指定された既定値が返されます。
Table.FromPartitions パーティション分割されたテーブルのセットを新しい列に結合した結果であるテーブルが返されます。 列の型を任意で指定できます。既定値は any です。
Table.InsertRows 行のリストがテーブルのインデックスの位置に挿入されたテーブルが返されます。 挿入する各行は、テーブルの行の型と一致している必要があります。
Table.Last テーブルの最後の行が返されます。
Table.LastN countOrCondition パラメーターに応じて、テーブルの最後の行 (1 行または複数行) が返されます。
Table.MatchesAllRows テーブル内のすべての行が条件を満たしている場合、true が返されます。
Table.MatchesAnyRows テーブル内のいずれかの行が条件を満たしている場合、true が返されます。
Table.Partition 各行の列の値とハッシュ関数に基づいて、テーブルをテーブルのグループ数のリストにパーティション分割します。 ハッシュ関数は、行のハッシュ値を取得するために、列の行の値に適用されます。 ハッシュ値の剰余グループによって、返されるテーブルのどれに行が配置されるかが決まります。
Table.PartitionValues テーブルをパーティション分割する方法に関する情報を返します。
Table.Range オフセットを開始位置として、指定された数の行をテーブルから返します。
Table.RemoveFirstN 最初の行を開始位置として、テーブルから指定された数の行が削除されたテーブルが返されます。 削除する行数は、省略可能な countOrCondition パラメーターに基づきます。
Table.RemoveLastN 最後の行を開始位置として、テーブルから指定された数の行が削除されたテーブルが返されます。 削除する行数は、省略可能な countOrCondition パラメーターに基づきます。
Table.RemoveRows オフセットを開始位置として、テーブルから指定された数の行が削除されたテーブルが返されます。
Table.RemoveRowsWithErrors テーブルから少なくとも行の 1 つのセルにエラーがあるすべての行が削除されたテーブルが返されます。
Table.Repeat テーブルの行がカウントの数だけ繰り返されたテーブルが返されます。
Table.ReplaceRows オフセットから始まる行がカウントの数だけ指定された行で置き換えられたテーブルが返されます。
Table.ReverseRows 行を逆順にしたテーブルが返されます。
Table.SelectRows 条件に一致する行のみを含むテーブルが返されます。
Table.SelectRowsWithErrors テーブル内の少なくとも行の 1 つのセルにエラーがある行のみが含まれたテーブルが返されます。
Table.SingleRow テーブルから 1 つの行が返されます。
Table.Skip テーブルの最初の行 (1 行または複数行) を含まないテーブルが返されます。
Table.SplitAt 最初の行 (指定された数の行) と残りの行を含むリストを返します。

列の操作

名前 Description
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 指定されたセット以外のすべての列が属性と値のペアに変換されます。その際、各行の残りの値と結合します。

変換

名前 Description
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 テーブル内のリスト列を指定すると、そのリスト内の値ごとに 1 行のコピーが作成されます。
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 など) を使用して、テーブルの特定の列で oldValue を newValue に置き換えます。
Table.SplitColumn 各値に分割関数を適用して、1 つの列から新しい列のセットが返されます。
Table.TransformColumns 1 つ以上の列の値を変換します。
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 Criteria.comparisonCriteria を使用して、テーブルから最大の行が返されます。
Table.MaxN テーブルから最大の N 行が返されます。 行が並べ替えられた後、結果をさらにフィルター処理するには、countOrCondition パラメーターを指定する必要があります。
Table.Min comparisonCriteria を使用して、テーブルから最小の行が返されます。
Table.MinN 指定されたテーブル内の最小の N 行が返されます。 行が並べ替えられた後、結果をさらにフィルター処理するには、countOrCondition パラメーターを指定する必要があります。
Table.AddRankColumn 1 つ以上の他の列のランキングが入った列を追加します。
Table.Sort comparisonCriteria または (指定されていない場合) 既定の順序を使用して、テーブル内の行を並べ替えます。

その他

名前 説明
Table.Buffer テーブルをメモリ内にバッファー処理して、評価中に外部から変更されないように分離します。

パラメーター値

出力列の名前付け

このパラメーターは、結果として得られるテーブルの列名を指定するテキスト値の一覧です。 このパラメーターは通常、テーブルの構築関数 (Table.FromRowsTable.FromList など) で使用されます。

比較条件

比較条件は、次のいずれかの値として指定できます。

  • 並べ替え順序を指定する数値。 詳細: 並べ替え順序

  • 並べ替えに使用するキーを計算するには、引数が 1 つの関数を使用できます。

  • キーと制御順序の両方を選択するには、キーと順序を含むリストを比較条件として指定できます。

  • 比較を完全に制御するには、引数が 2 つである関数を使用できます。これにより、左右の入力の関係によって、-1、0、または 1 が返されます。 Value.Compare は、このロジックを委任するために使用できます。

例については、「Table.Sort」の説明を参照してください。

Count または Condition 条件

この条件は通常、順序付けまたは行の操作で使用されます。 テーブルで返される行の数を決定し、数値または条件の 2 つの形式を取ることができます。

  • 数値は、適切な関数を使用してインラインで返す値の数を示します。

  • 条件が指定されている場合は、最初に条件を満たす値を含む行が返されます。 条件を満たさない値があると、それ以降の値は考慮されません。

詳細情報: Table.FirstNTable.MaxN

追加の値の処理

追加の値は、関数が行の追加の値を処理する方法を示すために使用されます。 このパラメーターは数値として指定され、以下のオプションにマップされます。

ExtraValues.List = 0 ExtraValues.Error = 1 ExtraValues.Ignore = 2

詳細情報: Table.FromListExtraValues.Type

列がない場合の処理

このパラメーターは、存在しない列を関数で処理する方法を示すために使用されます。 このパラメーターは数値として指定され、以下のオプションにマップされます。

MissingField.Error = 0 MissingField.Ignore = 1 MissingField.UseNull = 2;

このパラメーターは、列または変換操作 (Table.TransformColumns など) で使用されます。 詳細情報: MissingField.Type

並べ替え順序

並べ替え順序は、結果の並べ替え方法を示すために使用されます。 このパラメーターは数値として指定され、以下のオプションにマップされます。

Order.Ascending = 0 Order.Descending = 1

詳細情報: Order.Type

式の条件

テーブルの式の条件は、以下のいずれかで指定できます。

  • 次のいずれかの関数の値:

    • 等値条件を適用するためのテーブルの列を決定するキー セレクター。

    • 適用する比較の種類を指定ために使用される比較関数。 組み込みの比較関数を指定できます。 詳細情報: 比較関数

  • 等値条件を適用するテーブルの列のリスト

例については、「Table.Distinct」の説明を参照してください。