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