LOOKUPVALUE

適用於:匯出數據行計算數據表量值視覺計算

傳回符合一或多個搜尋條件所指定之所有準則的數據列值。

語法

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 )
    )

修訂後的公式會回傳參考產品的名稱,不論目前銷售列中的產品為何。 在此範例後恢復關係的原始交叉濾波方向。