本页中提及的
required_access_grants
参数是维度、维度组、衡量、过滤条件或参数的组成部分。
required_access_grants
也可以是探索的一部分,如required_access_grants
(适用于探索)参数文档页面所述。
required_access_grants
也可以是联接的一部分,如required_access_grants
(针对联接)参数文档页面所述。
required_access_grants
也可以是视图的一部分,如required_access_grants
(适用于视图)参数文档页面所述。
用法
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]
}
如果该用户无权使用分配给字段的所有访问权限,也无法访问相应字段。他们在探索时不会看到字段选择器中的字段。如果用户查看的 Lookout 包含受限字段,他们就会看到一条警告消息,提示“<view.field>
不再存在于 <view>
上,或者您无权访问它,系统会将其忽略”。信息中心卡片上不显示警告消息。
如需详细了解如何定义访问权限授权,请参阅 access_grant
文档页面。
示例
仅向有权访问 payroll
access_grant 的用户公开 salary
维度:
dimension: salary {
type: number
required_access_grants: [payroll]
}
其他注意事项
在已保存样式和信息中心内查看受限视图及计算字段
由于没有权限受限字段的用户无法访问该字段,这可能会导致所保存的 Look 或信息中心图块中查看的数据发生变化。
例如,使用受限维度的措施将无法访问受限维度中的数据,因此,如果没有该数据,则会进行测量汇总。因此,与有权访问受限维度的用户相比,无权访问受限维度的用户在结果中看到的结果将有所不同。
基于受限字段的表格计算会针对无权访问受限字段的用户显示错误,原因是计算表无权访问受限字段。