required_access_grants (para vistas)

En esta página, se hace referencia al parámetro required_access_grants que forma parte de una vista.

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

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

required_access_grants también puede formar parte de una dimensión, un grupo de dimensiones, una métrica, un filtro o un parámetro, como se describe en la página de documentación del parámetro required_access_grants (para campos) .

Uso

view: view_name {
  required_access_grants: [access_grant_name, access_grant_name, ...]
}
Jerarquía
required_access_grants
Valor predeterminado
Ninguno

Acepta
Corchetes que contienen una lista separada por comas de los nombres de las concesiones de acceso

Definición

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

required_access_grants funciona de la siguiente manera:

  1. Para definir un otorgamiento de acceso, usa el parámetro access_grant. Como parte de la definición, asocias el otorgamiento de acceso con un atributo del usuario. También especificas qué valores de atributos del usuario brindan acceso al permiso de acceso.
  2. A continuación, usarás required_access_grants para restringir una vista solo a los usuarios que tengan acceso a cada una de las concesiones de acceso que se indican.

Por ejemplo, el siguiente LookML requiere que los usuarios tengan acceso a los permisos de acceso can_view_financial_data y view_payroll para ver la vista payroll:

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

Los usuarios que no tengan acceso a todos los permisos de acceso asignados a la vista no verán ninguno de los campos en la vista restringida. No verán esos campos en el selector de campos mientras exploran. Si el usuario ve un Look que incluye campos de la vista restringida, verá 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 las tarjetas del panel.

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

Ejemplo

Expón la dimensión payroll solo a los usuarios que tengan acceso al permiso de acceso accounting:

view: payroll {
  ...
  required_access_grants: [accounting]
}

Consideraciones adicionales

Visualización de vistas restringidas con campos calculados en paneles y Vistas guardados

Dado que los usuarios que no tienen acceso a una vista restringida no pueden acceder a los campos de la vista, esto puede provocar cambios en los datos visualizados en una vista guardada o en una tarjeta del panel.

Por ejemplo, una medida que usa una dimensión de una vista restringida no tendrá acceso a los datos de esa vista, por lo que la agregación de la medida se realizará sin esos datos. Por lo tanto, los usuarios que no tienen acceso a la vista restringida ven resultados diferentes a los de los usuarios que sí tienen acceso a ella.

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

Restricción del acceso a las estructuras de LookML subyacentes

Restringir el acceso a una vista no restringe el acceso a sus estructuras de LookML subyacentes. Por lo tanto, un campo sin restricciones que forme parte de otras vistas seguirá estando disponible si esas vistas no tienen restricciones. Usa el parámetro required_access_grants a nivel del campo para restringir los campos de forma individual.