LOOKUPVALUE
返回满足一个或多个搜索条件所指定的所有条件的行的值。
语法
LOOKUPVALUE (
<result_columnName>,
<search_columnName>,
<search_value>
[, <search2_columnName>, <search2_value>]…
[, <alternateResult>]
)
parameters
| 术语 | 定义 |
|---|---|
| result_columnName | 包含要返回的值的现有列的名称。 它不能是表达式。 |
| search_columnName | 现有列的名称。 它可以位于 result_columnName 所在的表中，也可以位于相关表中。 它不能是表达式。 可以指定多对 search_columnName 和 search_value。 |
| search_value | 要在 search_columnName 中搜索的值。 可以指定多对 search_columnName 和 search_value。 |
| alternateResult | （可选）result_columnName 的上下文已筛选为零个或多个非重复值时，返回该值。 如果未指定，则当 result_columnName 筛选为零值时，函数将返回 BLANK，或者当 result_columnName 的上下文中存在多个非重复值时返回错误。 |
返回值
所有 search_columnName 和 search_value 对都匹配的行上的 result_columnName 的值。
如果没有符合所有搜索值的匹配项，则返回 BLANK 或 alternateResult（如果已指定）。 换句话说，如果仅部分条件匹配，则该函数不会返回查找值。
如果多行匹配搜索值，并且 result_columnName 中这些行的值相同，则返回该值。 但是，如果 result_columnName 返回不同的值，则返回错误或 alternateResult（如果已指定）。
备注
如果包含结果列的表和包含搜索列的表之间存在关系，则在大多数情况下，使用 RELATED 函数（而不是 LOOKUPVALUE）会更高效，并可以获得更好的性能。
可以指定多对 search_columnName 和 search_value。
在函数循环访问搜索表中的行之前，将计算 search_value 和 alternateResult 参数 。
避免使用 ISERROR 或 IFERROR 函数来捕获 LOOKUPVALUE 返回的错误。 如果输入某些值，函数无法确定单个输出值时，会导致错误，在这种情况下，提供 alternateResult 参数是处理该错误的最可靠、性能最高的方式。
如果在 Power Pivot 计算列中指定了 alternateResult 参数，该参数将返回错误。
在已计算的列或行级安全性 (RLS) 规则中使用时，不支持在 DirectQuery 模式下使用此函数。
示例 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
在此示例中，“销售额”表中定义的以下计算列使用 LOOKUPVALUE 函数返回来自“销售订单”表中的渠道值。
CHANNEL =
LOOKUPVALUE (
'Sales Order'[Channel],
'Sales Order'[SalesOrderLineKey],
[SalesOrderLineKey]
)
不过， 在这种情况下，由于“销售订单”表和“销售额”表之间存在关系，因此使用 RELATED 函数会更有效。
CHANNEL = RELATED('Sales Order'[Channel])