required_access_grants(适用于探索)

此页面涉及 探索的一部分 required_access_grants 参数。

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

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

required_access_grants 也可以是维度、维度组、度量、过滤条件或参数的一部分,如 required_access_grant 参数文档页面中所述。

用法

explore: explore_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 访问权限,才能查看 payroll 探索:

explore: payroll {
  ...
  required_access_grants: [can_view_financial_data, view_payroll]
}

如果用户无权访问分配给探索的所有访问权限,则根本无法看到该探索。他们无法查看基于相应探索的任何 Look 或信息中心图块,并且不会在探索菜单中看到相应探索。 如需详细了解如何定义访问权限授予,请参阅 access_grant 参数文档页面。

示例

仅向拥有 accounting 访问权限授予的用户公开 financial 探索:

explore: financial {
  ...
  required_access_grants: [accounting]
}

其他注意事项

限制对探索的访问权限并不会限制对相应底层 LookML 结构的访问权限。因此,如果其他探索不受限,那么作为这些探索一部分的不受限联接、视图或字段仍可使用。您可以在 joinviewfield 级别使用 required_access_grants 参数来单独限制这些项。