此页面链接到 join 参数的所有子 LookML 参数。如需详细了解如何使用联接，请参阅在 LookML 中使用联接文档页面。
联接可让您向单个探索添加多个视图，从而让用户能够同时访问和比较各个视图中的字段。您可以在模型文件中声明探索和任何所需的 join 参数。
用法示例
将鼠标悬停在参数名称上可查看简要说明；点击该名称可跳转到相应页面。 如果某个参数可以设置为多个特定选项中的一个，则默认值会列在最前面。
## STRUCTURAL PARAMETERS explore: explore_name { # Desired Explore parameters (described on Explore Parameters page) join: join_name { # DISPLAY PARAMETERS view_label: "desired label for the view" # JOIN PARAMETERS fields: [field_or_set, field_or_set, ...] foreign_key: dimension_name from: view_name outer_only: no | yes relationship: many_to_one | many_to_many | one_to_many | one_to_one required_joins: [view_name, view_name, ...] sql_on: SQL ON clause ;; sql_table_name: table_name ;; type: left_outer | cross | full_outer | inner # QUERY PARAMETERS required_access_grants: [access_grant_name, access_grant_name, ...] sql_where: SQL WHERE condition ;; } # Possibly more join declarations }
参数定义
| 参数名称 | 说明 |
|---|---|
| 结构参数 | |
join |
将其他视图与“探索”联接 |
| 展示参数 | |
view_label（用于联接） |
更改联接的视图名称在字段选择器中的显示方式 |
| 联接参数 | |
fields（用于联接） |
确定将联接中的哪些字段引入探索 |
foreign_key |
使用联接视图的主键指定探索与联接之间的关系 |
from（用于联接） |
指定联接所依据的视图 |
outer_only |
指定是否所有查询都必须使用外连接 |
relationship |
声明联接具有一对一、多对一、一对多或多对多关系 |
required_joins |
指定在选择某个联接中的字段时，应将哪些联接应用于探索 |
sql_on |
通过编写 SQL ON 子句来指定 Explore 与联接之间的关系 |
sql_table_name（用于联接） |
指定将基于哪个数据库表进行联接 |
type（用于联接） |
声明联接为左联接、完全联接、内联接或交叉联接类型 |
| 查询参数 | |
required_access_grants（用于联接） |
将联接的访问权限限制为仅限用户属性值与访问权限匹配的用户 |
sql_where |
如果查询中包含此联接，则会在查询的 WHERE 子句中插入用户无法针对此探索更改或移除的条件。（仅限 BigQuery） |
| 应避免的参数 | |
sql（用于联接） |
避免使用 3.10
已替换为 sql_on、foreign_key、type 和/或 sql_table_name 的组合，如此处所述
|
sql_foreign_key |
避免 3.16
已替换为 foreign_key |