Esta página se refere ao parâmetro
required_access_grants, que faz parte de uma dimensão, um grupo de dimensões, uma métrica, um filtro ou um parâmetro.
required_access_grantstambém pode fazer parte de uma análise detalhada, descrita na página de documentação do parâmetrorequired_access_grants(para análises detalhadas).
required_access_grantstambém pode fazer parte de uma junção, descrita na página de documentação do parâmetrorequired_access_grants(para junções).
required_access_grantstambém pode fazer parte de uma visualização, descrita na página de documentação do parâmetrorequired_access_grants(para visualizações).
Uso
view: view_name {
dimension: field_name {
required_access_grants: [access_grant_name, access_grant_name, ...]
}
}
|
Hierarquia
required_access_grants |
Tipos de campo possíveis
Dimensão, grupo de dimensões, métrica, filtro, parâmetro
Aceita
Colchetes contendo uma lista separada por vírgulas de nomes de concessão de acesso
|
Definição
required_access_grants funciona com o parâmetro access_grant no nível do modelo para limitar o acesso a um campo apenas aos usuários que têm um valor específico de atributo do usuário atribuído a eles.
O required_access_grants funciona assim:
- Você define uma concessão de acesso usando o parâmetro
access_grant. Como parte da definição, você associa a concessão de acesso a um atributo do usuário. Você também especifica quais valores de atributo do usuário fornecem acesso à concessão. - Em seguida, use
required_access_grantspara restringir o campo apenas aos usuários que têm acesso a todas as concessões listadas.
Por exemplo, a LookML a seguir exige que os usuários tenham acesso às concessões can_view_financial_data e view_payroll para ver a dimensão salary:
dimension: salary {
...
required_access_grants: [can_view_financial_data, view_payroll]
}
Os usuários que não têm acesso a todas as concessões atribuídas ao campo não poderão acessá-lo. Ele não vai aparecer no seletor de campos durante a análise detalhada. Se os usuários visualizarem um Look que inclui o campo restrito, uma mensagem de aviso vai aparecer informando que "<view.field> não existe mais em <view> ou você não tem acesso a ele, e ele será ignorado". A mensagem de aviso é suprimida nos blocos do painel.
Para mais informações sobre como definir uma concessão de acesso, consulte a página de documentação access_grant.
Exemplo
Exponha a dimensão salary apenas para os usuários que têm acesso à payroll access_grant:
dimension: salary {
type: number
required_access_grants: [payroll]
}
Outras considerações
Como acessar visualizações restritas com campos calculados em Looks e painéis salvos
Como os usuários sem acesso a um campo restrito não podem acessar esse campo, isso pode causar mudanças nos dados visualizados em um Look salvo ou um bloco do painel.
Por exemplo, uma consulta que usa uma dimensão restrita não terá acesso aos dados dela. Portanto, a agregação de métricas vai ocorrer sem essas informações. Assim, os usuários que não têm acesso à dimensão restrita vão ver resultados diferentes na métrica em comparação com os usuários que têm acesso.
Os cálculos de tabela baseados em um campo restrito mostram um erro para usuários que não têm acesso a ele, já que o cálculo de tabela não tem acesso ao campo restrito.