SUBSTITUTEWITHINDEX
傳回數據表,代表提供做為自變數之兩個數據表的左半聯結。 半聯結是使用通用數據行來執行,由通用數據行名稱和通用數據類型所決定。 所聯結的數據行會取代為傳回數據表中屬於整數且包含索引的單一數據行。 索引是指定排序順序之右聯結數據表的參考。
提供的右/秒數據表中的數據行不存在於所傳回數據表中,也不會包含在傳回的數據表中,而且不會用來聯結。
索引從 0 開始(以 0 為基礎),並在提供的右/秒聯結數據表中每一個額外數據列遞增一個。 索引是以針對右/秒聯結數據表指定的排序順序為基礎。
語法
SUBSTITUTEWITHINDEX(<table>, <indexColumnName>, <indexColumnsTable>, [<orderBy_expression>, [<order>][, <orderBy_expression>, [<order>]]…])
參數
詞彙 | [定義] |
---|---|
table |
要篩選的數據表,方法是執行左半聯結,並將數據表指定為第三個自變數 (indexColumnsTable) 。 這是左半聯結左側的數據表,因此傳回的數據表包含與這個數據表相同的數據行,不同之處在於兩個數據表的所有通用數據行都會取代為傳回數據表中的單一索引數據行。 |
indexColumnName |
字串,指定索引數據行的名稱,此數據行會取代兩個數據表中提供做為此函式自變數的所有通用數據行。 |
indexColumnsTable |
左半聯結的第二個數據表。 這是左側半聯結右側的數據表。 函式只會傳回此數據表中的值。 此外,此數據表的數據行(根據數據行名稱)將會取代為此函式所傳回之數據表中的單一索引數據行。 |
orderBy_expression |
任何 DAX 表示式,其中結果值是用來指定 indexColumnsTable 數據表的所需排序順序,以產生正確的索引值。 為 indexColumnsTable 資料表指定的排序順序會定義數據表中每個數據列的索引,而且該索引會用於傳回的數據表中,以表示 indexColumnsTable 中值的組合,因為它們出現在提供做為此函式的第一個自變數的數據表中。 |
order |
(選擇性)值,指定如何排序orderBy_expression值、遞增或遞減: 值: Desc 。 替代值:0 (零)/FALSE 。 以orderBy_expression值的遞減順序排序。 這是省略 order 參數時的預設值。值: ASC 。 替代值:1 /TRUE 。 依 orderBy_expression 的遞增順序排名。 |
傳回值
數據表,其中只包含indexColumnsTable 數據表中存在的值,而且其具有索引數據行,而不是indexColumnsTable 數據表中存在所有數據行(依名稱)。
備註
此函式不保證任何結果排序順序。
在匯出數據行或數據列層級安全性 (RLS) 規則中使用時,不支援在 DirectQuery 模式中使用此函式。