required_access_grants

本页中提及的 required_access_grants 参数是维度维度组衡量过滤条件参数的组成部分。

required_access_grants 也可以是探索的一部分,如 required_access_grants(适用于探索)参数文档页面所述。

required_access_grants 也可以是联接的一部分,如 required_access_grants(针对联接)参数文档页面所述。

required_access_grants 也可以是视图的一部分,如 required_access_grants(适用于视图)参数文档页面所述。

用法

视图: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 的工作原理如下:

  1. 您可以使用 access_grant 参数定义访问权限授予。根据定义,您可以将访问权限授予与用户属性相关联。还需要指定哪些用户属性值提供了访问权限。
  2. 接下来,您可以使用 required_access_grants 将该字段限制为仅有权访问有权访问所列的每项访问权限的用户。

例如,以下 LookML 要求用户必须同时具有 can_view_financial_dataview_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 或信息中心图块中查看的数据发生变化。

例如,使用受限维度的措施将无法访问受限维度中的数据,因此,如果没有该数据,则会进行测量汇总。因此,与有权访问受限维度的用户相比,无权访问受限维度的用户在结果中看到的结果将有所不同。

基于受限字段的表格计算会针对无权访问受限字段的用户显示错误,原因是计算表无权访问受限字段。