Esta página se refere ao parâmetro
required_access_grants
que faz parte de uma dimensão, grupo de dimensões, medida, filtro ou parâmetro.O
required_access_grants
também pode fazer parte de um "Explorar", descrito na página de documentação do parâmetrorequired_access_grants
(para "explores").
required_access_grants
também pode fazer parte de uma mesclagem, descrita na página de documentação do parâmetrorequired_access_grants
(para mesclagens).
required_access_grants
também pode fazer parte de uma visualização, descrita na página de documentação do parâmetrorequired_access_grants
(para visualizações).
Uso
dimensão: 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, medir, filtro, parâmetroAceita
Colchetes contendo uma lista separada por vírgulas de nomes de concessão de acesso |
Definição
O required_access_grants
faz o pareamento com o parâmetro access_grant
no nível do modelo, para limitar o acesso de um campo somente aos usuários que tenham um valor específico de atributo do usuário.
required_access_grants
funciona assim:
- Defina uma concessão de acesso usando o parâmetro
access_grant
. Como parte da definição, você associa o benefício de acesso a um atributo do usuário. Você também especifica quais valores de atributo do usuário concedem acesso. - Em seguida, use
required_access_grants
para restringir o campo apenas aos usuários que têm acesso a cada concessão de acesso listada.
Por exemplo, o LookML a seguir exige que os usuários tenham acesso às concessões de acesso 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 tiverem acesso a todas as concessões de acesso atribuídas ao campo não terão acesso a ele. Durante a exploração, eles não verão o campo no seletor de campo. Se os usuários visualizarem um Look que inclua o campo restrito, eles verão uma mensagem de aviso dizendo "<view.field>
não existe mais em <view>
ou você não tem acesso a ele e será ignorado". A mensagem de aviso é suprimida nos blocos do painel de controle.
Para mais informações sobre como definir uma concessão de acesso, consulte a página de documentação do access_grant
.
Exemplo
Exponha a dimensão salary
apenas aos usuários que têm acesso à permissão access_grant payroll
:
dimension: salary {
type: number
required_access_grants: [payroll]
}
Outras considerações
Visualização de visualizações restritas com campos calculados em aparências e painéis salvos
Como os usuários que não têm acesso a um campo restrito não conseguem acessar esse campo, isso pode causar mudanças nos dados visualizados em um bloco salvo do painel ou do Lookout.
Por exemplo, uma medida que usa uma dimensão restrita não tem acesso aos dados nela, portanto, a agregação de medida ocorre sem esses dados. Assim, os usuários que não têm acesso à dimensão restrita veem resultados diferentes na métrica do que aqueles que têm acesso a ela.
Os cálculos da tabela com base em um campo restrito exibem um erro para usuários que não têm acesso ao campo restrito, já que o cálculo da tabela não tem acesso a esse campo.