Esta página se refere ao parâmetro
required_access_grants
que faz parte de umjoin
.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 visualização, descrita na página de documentação do parâmetrorequired_access_grants
(para visualizações).A
required_access_grants
também pode fazer parte de uma dimensão, grupo de dimensões, medida, filtro ou parâmetro descrito na página de documentação de parâmetrosrequired_access_grants
.
Uso
join: view_name {
required_access_grants: [access_grant_name, access_grant_name, ...]
}
}
Hierarquia
required_access_grants |
Valor padrão
NenhumaAceita
Colchetes contendo uma lista separada por vírgulas de nomes de concessão de acesso |
Definição
required_access_grants
combina com o parâmetro access_grant
no nível do modelo para limitar o acesso de uma mesclagem apenas aos usuários que receberam 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 a mesclagem apenas aos usuários com acesso a cada concessão de acesso listada.
Esse LookML exige que os usuários tenham acesso às concessões de acesso can_view_financial_data
e view_payroll
para ver a mesclagem de payroll
:
join: payroll {
...
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 à mesclagem não verão os campos adicionados a uma opção "Explorar" pela mesclagem restrita. Durante a exploração, eles não verão esses campos no seletor de campos. Se os usuários visualizarem um Look que inclua campos aos quais eles não têm acesso, eles verão uma mensagem de aviso que diz: "<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 de controle.
Para mais informações sobre como definir uma concessão de acesso, consulte a página de documentação do parâmetro access_grant
.
Exemplo
Exponha a mesclagem de payroll
apenas a usuários que tenham acesso à concessão de acesso pr_dept
:
explore: financial {
join: payroll {
...
required_access_grants: [pr_dept]
}
}
Outras considerações
Visualização de junções restritas com campos calculados em visuais e painéis salvos
Como os usuários que não têm acesso a uma mesclagem restrita não conseguem ver os campos adicionados pela mesclagem, isso pode mudar os dados exibidos em um bloco de painel ou de aparência salvo.
Por exemplo, uma medida que usa uma dimensão de uma mesclagem restrita não terá acesso aos dados dessa dimensão. Portanto, a agregação de medida ocorre sem esses dados. Assim, os usuários que não têm acesso à mesclagem restrita verão dados diferentes da medida dos usuários que têm acesso à mesclagem restrita.
Os cálculos da tabela baseados em um campo de uma mesclagem restrita mostram um erro para os usuários que não têm acesso à mesclagem restrita, já que o cálculo da tabela não tem acesso ao campo nessa mesclagem.
Como restringir o acesso a estruturas LookML subjacentes
Restringir o acesso a uma mesclagem não restringe o acesso às estruturas subjacentes do LookML. Uma visualização ou um campo irrestrito que faça parte de outras junções ainda estará disponível. Use o parâmetro required_access_grants
no nível da vista ou do campo para restringir esses itens individualmente.