required_access_grants (para campos)

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

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 vista, como se describe 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, métrica, filtro y parámetro 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 un campo solo a los usuarios que tienen un valor de atributo del usuario específico asignado.

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, usas required_access_grants para restringir el campo solo a los usuarios que tienen acceso a cada otorgamiento de acceso que se indica.

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 dimensión salary:

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

Los usuarios que no tengan acceso a todos los permisos de acceso asignados al campo no podrán acceder a él. No verán el campo en el selector de campos mientras exploran. Si los usuarios ven un Look 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 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 de access_grant.

Ejemplo

Expón la dimensión salary solo a los usuarios que tengan acceso al objeto access_grant de payroll:

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

Consideraciones adicionales

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

Dado que los usuarios que no tienen acceso a un campo restringido no pueden acceder a él, esto puede provocar cambios en los datos que se ven en un Look guardado o en una tarjeta del panel.

Por ejemplo, una consulta que usa una dimensión restringida no tendrá acceso a los datos de esa dimensión, por lo que la agregación de la métrica se realizará sin esos datos. Por lo tanto, los usuarios que no tengan acceso a la dimensión restringida verán resultados diferentes en la métrica que los usuarios que sí tengan acceso a la dimensión restringida.

Los cálculos de tabla basados en un campo restringido muestran un error para los usuarios que no tienen acceso a ese campo, ya que el cálculo de tabla no tiene acceso a él.