查找

適用於:計算結果列匯出數據表視覺計算

傳回值,或使用絕對導覽從可視化矩陣評估表達式。 視覺效果矩陣上的任何軸都可以提供篩選。 任何省略的篩選條件都會從內容推斷。 如果無法判斷任何單一值,則會傳回錯誤。

語法

LOOKUP(<expression>, <colref>, <expression>[, <colref>, <expression>]...[, <AssociatedColumnsBehavior>])

參數

術語 定義
expression 要評估的表達式。
colref (選擇性)要篩選的數據行。
expression (選擇性)要篩選的值。
AssociatedColumnsBehavior (可選)規定如何處理相關欄位。 允許的值為 EXPLICIT (預設值)或 INFERRED

返回值

套用 篩選條件之後 表達式的值。

如果沒有相符專案,則會傳回錯誤。

如果多個數據列符合篩選條件,則會傳回錯誤。

備註

AssociatedColumnsBehavior 參數控制 LOOKUP 如何處理由所提供座標功能決定的軸欄位:

  • EXPLICIT (預設):當參數被省略或設為 EXPLICIT時,LOOKUP 只會使用你明確提供的篩選條件。 未指定的軸欄位則是從當前上下文推斷出來的。 這是原始的 LOOKUP 行為。

  • 推斷:當設定為 INFERRED時,引擎會自動識別由所提供座標功能決定的軸列,並在評估查找前填入。 例如,如果你依年、季、月篩選,引擎可以推斷出對應這些座標的相關欄位,例如日或週。

INFERRED 被指定,且你提供本應推斷的欄位值時,所提供的值會與推斷值進行驗證。 如果它們互相衝突,呼叫會回傳 BLANK,就像 EXPLICIT 你提供衝突座標時回傳 BLANK 的做法一樣。

範例 1

在此範例中,LOOKUP 會擷取自行車類別的銷售總和。 第一個自變數可以是數據行或純量表達式。

Lookup Example 1 = LOOKUP(SUM([Sales Amount]),  [Category], "Bikes")
Lookup Example 2 = LOOKUP([Sales Amount], [Category], "Bikes")

下列螢幕快照顯示具有兩個視覺計算的矩陣。

查閱範例 1

範例 2

在此範例中, LookupExample2 視覺效果計算會擷取會計 年度 FY2018 的銷售總和。 請注意,自未明確指定數據列之後,將會使用數據列的四分之一篩選,因此 FY2019 Q1FY2019 Q4 沒有傳回任何結果,因為 FY2018FY2019 Q1 的組合到 FY2019 Q4 並不存在。 LookupExample3 會明確指定季,因此不會考慮數據列上的目前季。

LookupExample2 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018")
LookupExample3 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018", [Fiscal Quarter], "FY2018 Q1")

查閱範例 2

範例 3

這個例子展示了行為與 INFERRED 之間的差異EXPLICIT。 兩種視覺計算都是透過指定年份、季度及月份名稱座標,查詢2025年1月的銷售總和。

Jan 2025 Sales (Explicit) = LOOKUP([Sum of Sales], [Year], 2025, [Quarter], "Q1", [Month Name], "January", EXPLICIT)
Jan 2025 Sales (Inferred) = LOOKUP([Sum of Sales], [Year], 2025, [Quarter], "Q1", [Month Name], "January", INFERRED)

EXPLICIT時,查詢只會回傳當前上下文與指定座標相符的列(2025 年 1 月的列)。 在其他所有列中,查詢會回傳 BLANK ,因為當前列的上下文與指定的篩選器衝突。

INFERRED,引擎會自動識別由年份、季度及月份名稱座標功能決定的相關欄位。 由於這些座標唯一地識別某個時間點,查詢會回傳矩陣中所有列的值。

查找範例 3 顯示顯式行為與推斷行為