テーブル関数
これらの関数は、テーブル値を作成および操作します。
テーブルの構築
| 名前 | 説明 |
|---|---|
| #table | 列と行からテーブル値を作成します。 |
| ItemExpression.From | 関数の本体の抽象構文ツリー (AST) を返します。 |
| ItemExpression.Item | 項目式の項目を表す抽象構文ツリー (AST) ノード。 |
| RowExpression.Column | 行式内の列へのアクセスを表す抽象構文ツリー (AST) を返します。 |
| RowExpression.From | 関数の本体の抽象構文ツリー (AST) を返します。 |
| RowExpression.Row | 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 | 少なくとも 1 つのセルにエラーが含まれている入力テーブルから行が削除されたテーブルを返します。 列リストが指定されている場合、指定された列のセルのみがエラーを検査されます。 |
| Table.Repeat | 指定した回数だけテーブルの行を繰り返します。 |
| Table.ReplaceRows | 指定した行の範囲を、提供された1行または複数行に置き換えます。 |
| Table.ReverseRows | 行の順序が逆のテーブルを返します。 |
| Table.SelectRows | 条件関数を満たす行を選択します。 |
| Table.SelectRowsWithErrors | 少なくとも 1 つのセルにエラーが含まれる入力テーブルの行のみを含むテーブルを返します。 列リストが指定されている場合、指定された列のセルのみがエラーを検査されます。 |
| Table.SingleRow | テーブル内の 1 行を返します。 |
| 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 | 指定されたキーに基づいてあいまい一致する 2 つのテーブルの行を結合します。 |
| Table.FuzzyNestedJoin | 指定された列のテーブル間であいまい結合を実行し、結合結果を新しい列に生成します。 |
| Table.Group | 同じキーを持つテーブル内の行をグループ化します。 |
| Table.Join | 指定されたキーに基づいて、一致する 2 つのテーブルの行を結合します。 |
| Table.Keys | 指定したテーブルのキーを返します。 |
| Table.NestedJoin | 指定された列でテーブル間の結合を実行し、結合結果を新しい列に生成します。 |
| Table.ReplaceErrorValues | 指定した列のエラー値を、対応する指定した値に置き換えます。 |
| Table.ReplaceKeys | 指定したテーブルのキーを置き換えます。 |
| Table.ReplaceRelationshipIdentity | この関数は、内部使用のみを目的としています。 |
| Table.ReplaceValue | 指定した列の値を別の値に置き換えます。 |
| Table.Split | 指定したページ サイズを使用して、指定したテーブルをテーブルの一覧に分割します。 |
| Table.SplitColumn | 指定した分割関数を使用して、指定した列を追加の列のセットに分割します。 |
| Table.TransformColumns | 1 つ以上の列の値を変換します。 |
| Table.TransformColumnTypes | 特定のカルチャを使用して、{column, type } という形式の型変換を適用します。 |
| Table.TransformRows | 指定した変換関数を使用して、テーブルの行を変換します。 |
| Table.Transpose | 列を行に、行を列に変換します。 |
メンバーシップ
| 名前 | 説明 |
|---|---|
| Table.Contains | 指定したレコードがテーブル内の行として表示されるかどうかを示します。 |
| Table.ContainsAll | 指定したすべてのレコードがテーブル内の行として表示されるかどうかを示します。 |
| Table.ContainsAny | 指定したレコードのいずれかがテーブル内の行として表示されるかどうかを示します。 |
| Table.Distinct | テーブルから重複する行を削除します。 |
| Table.IsDistinct | テーブルに個別の行 (重複なし) のみが含まれているかどうかを示します。 |
| Table.PositionOf | テーブル内の行の位置を返します。 |
| Table.PositionOfAny | テーブル内の指定された行の位置または位置を返します。 |
| Table.RemoveMatchingRows | 指定した行のすべての出現箇所をテーブルから削除します。 |
| Table.ReplaceMatchingRows | 指定したすべての行を提供された行または行群に置き換えます。 |
順序付け
| 名前 | 説明 |
|---|---|
| Table.AddRankColumn | 1 つ以上の他の列のランク付けを含む列を追加します。 |
| Table.Max | 指定された条件を使用して、最大の行または既定値を返します。 |
| Table.MaxN | 指定された条件を使用して、最大の行を返します。 |
| Table.Min | 指定された条件を使用して、最小の行または既定値を返します。 |
| Table.MinN | 指定された条件を使用して、最小の行を返します。 |
| Table.Sort | 1 つ以上の列名と比較条件を使用してテーブルを並べ替えます。 |
その他
| 名前 | 説明 |
|---|---|
| Table.Buffer | テーブルをメモリ内にバッファーし、評価中に外部の変更から分離します。 |
| Table.StopFolding | ダウンストリーム操作がデータの元のソースに対して実行されないようにします。 |
パラメーター値
出力列の名前付け
このパラメーターは、結果のテーブルの列名を指定するテキスト値のリストです。 このパラメーターは、Table.FromRows や Table.FromListなど、Table 構築関数で一般的に使用されます。
比較基準
比較条件は、次のいずれかの値として指定できます。
並べ替え順序を指定する数値。 詳細: 並べ替え順序
並べ替えに使用するキーを計算するには、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の説明に移動します。