テーブル関数

[アーティクル]
04/06/2023

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

テーブルの構築

名前	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.FromRows、Table.FromList など) で使用されます。

比較条件

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

並べ替え順序を指定する数値。詳細: 並べ替え順序
並べ替えに使用するキーを計算するには、引数が 1 つの関数を使用できます。
キーと制御順序の両方を選択するには、キーと順序を含むリストを比較条件として指定できます。
比較を完全に制御するには、引数が 2 つである関数を使用できます。これにより、左右の入力の関係によって、-1、0、または 1 が返されます。 Value.Compare は、このロジックを委任するために使用できます。

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

Count または Condition 条件

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

数値は、適切な関数を使用してインラインで返す値の数を示します。
条件が指定されている場合は、最初に条件を満たす値を含む行が返されます。条件を満たさない値があると、それ以降の値は考慮されません。

詳細情報: 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」の説明を参照してください。