此页面涉及的
required_access_grants参数属于维度、维度组、度量、过滤条件或参数。
required_access_grants也可以是探索的一部分，如required_access_grants（针对探索）参数文档页面中所述。
required_access_grants也可以是联接的一部分，如required_access_grants（用于联接）参数文档页面中所述。
required_access_grants也可以是视图的一部分，如required_access_grants（对于视图）参数文档页面中所述。
用法
view: view_name {
dimension: field_name {
required_access_grants: [access_grant_name, access_grant_name, ...]
}
}
|
层次结构
required_access_grants |
可能的字段类型
维度、维度组、度量、过滤条件、参数
接受
方括号，其中包含以英文逗号分隔的访问权限授予名称列表
|
定义
required_access_grants 与模型级 access_grant 参数搭配使用，可将字段的访问权限限制为仅限分配了特定用户属性值的用户。
required_access_grants 的工作原理如下：
- 您可以使用
access_grant参数定义访问权限授予。在定义中，您需要将访问权限授予与用户属性相关联。您还可以指定哪些用户属性值可授予访问权限。 - 接下来，您可以使用
required_access_grants将字段限制为仅供有权访问所列各项访问权限的用户使用。
例如，以下 LookML 要求用户同时拥有 can_view_financial_data 和 view_payroll 访问权限，才能查看 salary 维度：
dimension: salary {
...
required_access_grants: [can_view_financial_data, view_payroll]
}
如果用户无权访问分配给该字段的所有访问权限授予，则无法访问该字段。在探索时，他们不会在字段选择器中看到该字段。如果用户查看包含受限字段的 Look，系统会显示一条警告消息，指出“<view.field> 在 <view> 中已不存在，或者您无权访问，因此它会被忽略。”信息中心板块上不再显示警告消息。
如需详细了解如何定义访问权限授予，请参阅 access_grant 文档页面。
示例
仅向有权访问 payroll access_grant 的用户公开 salary 维度：
dimension: salary {
type: number
required_access_grants: [payroll]
}
其他注意事项
在已保存的 Look 和信息中心内查看包含计算字段的受限视图
由于无权访问受限字段的用户无法访问该字段，因此这可能会导致已保存的 Look 或信息中心图块中显示的数据发生变化。
例如，使用受限维度的查询将无法访问受限维度中的数据，因此系统会在没有该数据的情况下进行指标聚合。因此，无法访问受限维度的用户在衡量指标中看到的结果，与可以访问受限维度的用户看到的结果不同。
如果用户无权访问受限字段，则基于受限字段的表格计算会显示错误，因为表格计算无法访问受限字段。