# **LOOKUP**

从指定表中查询指定数据行数据，其中查询表(lookup\_table)需要有且只有一个主键。

## 语法{#grammar}

LOOKUP(**lookup\_value**, **lookup\_table**, **\[lookup\_field]**)

- **lookup\_value**：必需。要查找的数值，对应模型表中的主键值，既可以是单元格对象，也可以是一个表达式。
- **lookup\_table**：必需。待查找数值的数据表，只能写页面内的引入了的模型变量（不是字符串），不能直接写表路径。
- **lookup\_field**：查询属性名，可以是字段名或字段名称。仅当模型的主键设置了文字字段时，可以不传，默认返回文字字段。

<!-- **示例地址：** [LOOKUP](https://demo.succbi.com/v5/bi/lookup) -->

## 示例{#example}

1. `LOOKUP('110101',[销售单位])` 获取110101在模型表`[销售单位]`中对应的`ID`
2. `LOOKUP(B3,[销售单位],'XSDWMC')` 返回B3单元格的值在模型表`[销售单位]`中`XSDWMC`字段对应的值
3. `LOOKUP('SLFS00087',[终端门店],'门店名称')` 返回SLFS00087的值在模型表`[终端门店]`对应的`门店名称`字段值