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, 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, descrita en la página de documentación del parámetro required_access_grants (para combinaciones).

required_access_grants también puede ser parte de una dimensión, un grupo de dimensiones, una medida, un filtro o un parámetro, que se describe en la página de documentación del parámetro required_access_grants.

Uso

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

Jerarquía Ver archivo view required_access_grants

Valor predeterminado Ninguna 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 una vista 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 una vista solo a los usuarios que tienen acceso a cada otorgamiento de acceso indicado.

Por ejemplo, el siguiente LookML requiere que los usuarios tengan acceso a las concesiones 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 de la vista restringida. No verán esos campos en el selector de campos mientras los exploren. Si el usuario ve un estilo 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 los mosaicos del panel.

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

Ejemplo

Expón la dimensión payroll solo a aquellos usuarios que tienen acceso a la concesión de acceso accounting:

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

Consideraciones adicionales

Cómo ver las vistas restringidas con los campos calculados en los paneles y la apariencia guardados

Dado que los usuarios que no tienen acceso a una vista restringida no pueden acceder a los campos de la vista, es posible que se produzcan cambios en los datos vistos en una vista guardada o un mosaico del panel.

Por ejemplo, una medida que utiliza una dimensión de una vista restringida no tendrá acceso a los datos de esa vista, 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 vista restringida ven resultados diferentes de los que sí tienen acceso.

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

Restringe el acceso a las estructuras subyacentes de LookML

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