SUBSTITUTEWITHINDEX
引数として指定された 2 つのテーブルの左側の準順結合を表すテーブルを返します。 準結合は、共通の列名と共通のデータ型によって決定される共通列を使用して実行されます。 結合される列は、整数型でありインデックスが含まれている、返されたテーブル内の 1 つの列に置き換えられます。 インデックスは、指定された並べ替え順序が適用される右結合テーブルへの参照です。
指定された左/1 番目のテーブルに存在しない、右/2 番目のテーブル内の列は、返されたテーブルには含まれず、結合には使用されません。
インデックスの開始位置は 0 (0 から始まる) であり、指定された右/2 番目の結合テーブル内の追加行ごとに 1 ずつ増加します。 インデックスは、右/2 番目の結合テーブルに指定された並べ替え順序に基づいています。
構文
SUBSTITUTEWITHINDEX(<table>, <indexColumnName>, <indexColumnsTable>, [<orderBy_expression>, [<order>][, <orderBy_expression>, [<order>]]…])
パラメーター
| 用語 | 定義 |
|---|---|
| テーブル | 3 番目の引数 (indexColumnsTable) として指定されたテーブルとの左の準結合を実行することによってフィルター処理されるテーブル。 これは左の準結合の左側にあるテーブルであるため、返されるテーブルには、このテーブルと同じ列が含まれます。ただし、2 つのテーブルのすべての共通列が、返されるテーブル内の単一のインデックス列に置き換えられる場合は例外です。 |
| indexColumnName | この関数の引数として指定された 2 つのテーブル内のすべての共通列に取って代わるインデックス列の名前を指定する文字列。 |
| indexColumnsTable | 左の準結合の 2 番目のテーブル。 これは、左の準結合の右側にあるテーブルです。 このテーブルに存在する値のみが関数によって返されます。 また、このテーブルの列 (列名に基づく) は、この関数によって返されるテーブル内の単一のインデックス列に置き換えられます。 |
| orderBy_expression | 任意の DAX 式。この式では、結果の値を使用して、正しいインデックス値を生成するために indexColumnsTable テーブルの目的の並べ替え順序が指定されます。 IndexColumnsTable テーブルに指定された並べ替え順序により、テーブル内の各行のインデックスが定義されます。そのインデックスは、この関数の最初の引数として指定されたテーブルに表示される indexColumnsTable の値の組み合わせを表すために返されるテーブルで使用されます。 |
| 順序 | (省略可能) orderBy_expression 値を昇順または降順に並べ替える方法を指定する値。 値:Desc。 代替値: 0(zero)/FALSE。 orderBy_expression の値を降順で並べ替えます。 これは、order パラメーターを省略した場合の既定値です。 値:ASC。 代替値: 1/TRUE。 OrderBy_expression の昇順でランク付けします。 |
戻り値
indexColumnsTable テーブルに存在する値のみを含むテーブルであり、indexColumnsTable テーブルに存在するすべての列 (名前) ではなく、インデックス列を持つテーブル。
解説
この関数では、結果の並べ替え順序は保証されません。
この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。