required_access_grants

En esta página, se hace referencia al parámetro required_access_grants que forma parte de una dimensión, un grupo de dimensiones, un parámetro de medición, un filtro o un parámetro.

required_access_grants también puede formar parte de una exploración, descrita en la página de documentación del parámetro required_access_grants (para Explorar).

required_access_grants también puede ser parte de una unión, que se describe en la página de documentación del parámetro required_access_grants (para las uniones).

required_access_grants también puede ser parte de una vista, descrita en la página de documentación del parámetro required_access_grants (para vistas).

Uso

view: view_name {
dimension: field_name {
required_access_grants: [access_grant_name, access_grant_name, ...]
}
}

Jerarquía Ver archivo view Tipo de campo required_access_grants

Tipos de campos posibles Dimensión, grupo de dimensiones, medición, filtro, parámetro Acepta Corchetes con una lista separada por comas de nombres de permisos de acceso

Definición

required_access_grants se vincula con el parámetro access_grant a nivel de modelo para limitar el acceso de un campo solo a los usuarios que tienen asignado un valor de atributo de usuario específico.

required_access_grants funciona de la siguiente manera:

1. Para definir una concesión de acceso, usa el parámetro access_grant. Como parte de la definición, asocias la concesión de acceso con un atributo de usuario. También debes especificar qué valores de atributos de usuario proporcionan acceso a la concesión de acceso.
2. A continuación, usa required_access_grants para restringir el campo a solo los usuarios que tienen acceso a todos los permisos otorgados.

Por ejemplo, la siguiente LookML requiere que los usuarios tengan acceso a las concesiones de acceso can_view_financial_data y view_payroll para ver la dimensión salary:

dimension: salary {
  ...
  required_access_grants: [can_view_financial_data, view_payroll]
}

Los usuarios que no tienen acceso a todos los permisos de acceso asignados al campo no tendrán acceso al campo. No verán el campo en el selector de campos mientras lo exploran. Si los usuarios ven un estilo que incluye el campo restringido, verán un mensaje de advertencia que dice "<view.field> ya no existe en <view>, o no tienes acceso a él, y se ignorará". El mensaje de advertencia se suprime en los mosaicos del panel.

Para obtener más información sobre cómo definir un otorgamiento de acceso, consulta la página de documentación de access_grant.

Ejemplo

Expón la dimensión salary solo a los usuarios que tienen acceso a payroll access_grant:

dimension: salary {
  type: number
  required_access_grants: [payroll]
}

Consideraciones adicionales

Visualiza vistas restringidas con campos calculados en los paneles y aspectos guardados

Dado que los usuarios que no tienen acceso a un campo restringido no pueden acceder a ese campo, es posible que se produzcan cambios en los datos vistos en un mosaico guardado o un mosaico del panel.

Por ejemplo, una medida que utiliza una dimensión restringida no tendrá acceso a los datos de la dimensión restringida, por lo que la agregación de la medición se realiza sin esos datos. Por lo tanto, los usuarios que no tienen acceso a la dimensión restringida verán resultados diferentes en la medición que aquellos que no tienen acceso a esa dimensión.

Los cálculos de tablas basados en un campo restringido muestran un error para los usuarios que no tienen acceso al campo restringido, ya que el cálculo de la tabla no tiene acceso al campo restringido.