傳回符合一或多個搜尋條件所指定之所有準則的數據列值。
語法
LOOKUPVALUE (
<result_columnName>,
<search_columnName>,
<search_value>
[, <search2_columnName>, <search2_value>]…
[, <alternateResult>]
)
參數
| 術語 | 定義 |
|---|---|
result_columnName |
包含您要傳回之值的現有資料行名稱。 這不可能是個說法。 |
search_columnName |
現有數據行的名稱。 它可以位於與result_columnName或相關數據表相同的數據表中。 這不可能是個說法。 你可以指定多對search_columnName和search_value。 |
search_value |
在 search_columnName 中搜尋的值。 你可以指定多對search_columnName和search_value。 |
alternateResult |
(可選)當 上下文被篩選到零或多個不同值時,該值會回傳result_columnName。 若未指定,當 result_columnName 被篩選至零值時,函式會回傳;當 result_columnName 的上下文有多個不同值時,函式會回傳 BLANK 錯誤。 |
傳回值
數據列 result_columnName 的值,其中所有配對 search_columnName 和 search_value 都有完全相符的專案。
若無匹配滿足所有搜尋值,函數回傳 BLANK 或 alternateResult (若指定)。 換句話說,如果只有部分準則相符,函式就不會傳回查閱值。
如果多列的搜尋值相符且這些列的 result_columnName 值相同,該值就會回傳。 然而,如果 result_columnName 回傳不同的值,函數會回傳錯誤或 alternateResult (若有指定)。
言論
如果包含結果欄位的資料表與包含搜尋欄位的資料表之間存在關係,在大多數情況下,使用函 RELATED 式代替 LOOKUPVALUE 則更有效率且效能更好。
你可以指定多個 和
search_columnNamesearch_value的對。在函式逐一查看搜尋數據表的數據列之前,會先評估
search_value和alternateResult參數。在列上下文中評估時, LOOKUPVALUE 會執行上下文轉換,例如 CALCULATE將當前列轉換為過濾器。 在計算欄位中,這可能會產生對同一表格中其他欄位的依賴,即使表達式並未明確引用那些欄位。 這些相依關係可能導致循環相依錯誤。
LOOKUPVALUE以與該表相同的過濾去除行為ALL,從包含
result_columnName的表格中移除過濾器。 透過雙向關係從其他資料表傳播的濾波器仍可能影響查詢結果。 範例 3 展示了如何在原始資料表的過濾器中移除,避免這些過濾器限制查詢。避免使用 ISERROR 或 IFERROR 擷取由 返回的 LOOKUPVALUE錯誤。 如果某些輸入導致無法確定單一輸出值而產生錯誤,提供
alternateResult參數是最可靠且效能最高的處理錯誤方式。alternateResult參數會在Power Pivot計算結果列中指定時傳回錯誤。-
在匯出數據行或數據列層級安全性 (RLS) 規則中使用時,不支援在 DirectQuery 模式中使用此函式。
本文中的範例可以搭配範例 Adventure Works DW 2020 Power BI Desktop 模型使用。 若要取得模型,請參閱 DAX 範例模型。
範例 1
在此範例中, LOOKUPVALUE 搜尋訂單下達當天用於支付該貨幣的平均匯率:
Exchange Rate =
LOOKUPVALUE (
'Currency Rate'[Average Rate],
'Currency Rate'[CurrencyKey], [CurrencyKey],
'Currency Rate'[DateKey], [OrderDateKey]
)
你需要同時取得訂單日期和貨幣,才能找到正確日期和貨幣的平均利率。 OrderDateKey 和 CurrencyKey 是用來查閱貨幣匯率數據表中平均值的索引鍵。
您可以使用匯率,以下列方式計算當地貨幣的銷售金額:
Sales Amount Local Currency =
[Sales Amount] * [Exchange Rate]
範例 2
在此範例中,Sales 數據表中定義的下列匯出數據行會使用 LOOKUPVALUE 函數,從 Sales Order 數據表傳回通道值。
CHANNEL =
LOOKUPVALUE (
'Sales Order'[Channel],
'Sales Order'[SalesOrderLineKey], [SalesOrderLineKey]
)
然而,在這種情況下,因為 銷售訂單 與 銷售 資料表之間存在關係,使用這個 RELATED 函式會更有效率。
CHANNEL =
RELATED ( 'Sales Order'[Channel] )
範例 3
在此範例中,將 Product[ProductKey] 與 Sales[ProductKey] 之間的交叉濾波器方向改為 兩者皆為。 這讓 銷售 上的篩選器能過濾 產品。
以下 銷售欄位的 計算欄位會查詢固定參考產品的名稱。 使用參考產品,而非目前銷售列的產品,展示了雙向過濾器如何限制查詢。
Reference Product Name =
VAR ReferenceProductKey = 528
RETURN
LOOKUPVALUE ( 'Product'[Product], 'Product'[ProductKey], ReferenceProductKey )
內部上下文轉換會從目前 銷售 列建立篩選條件。 這些過濾器透過雙向關係傳播到 Product 。 對於銷售列使用不同產品鍵,查詢會回傳 BLANK ,即使參考產品存在。
將計算欄位的公式替換為以下表達式。 REMOVEFILTERS 清除查詢前由上下文轉換所建立的 銷售 篩選器:
Reference Product Name =
VAR ReferenceProductKey = 528
RETURN
CALCULATE (
LOOKUPVALUE ( 'Product'[Product], 'Product'[ProductKey], ReferenceProductKey ),
REMOVEFILTERS ( Sales )
)
修訂後的公式會回傳參考產品的名稱,不論目前銷售列中的產品為何。 在此範例後恢復關係的原始交叉濾波方向。