required_access_grants (para mesclagens)

Esta página se refere ao parâmetro required_access_grants que faz parte de um join.

O required_access_grants também pode fazer parte de um "Explorar", descrito na página de documentação do parâmetro required_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âmetro required_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âmetros required_access_grants.

Uso

explore: explore_name {
join: view_name {
required_access_grants: [access_grant_name, access_grant_name, ...]
}
}

Hierarquia Arquivo de modelo explore join required_access_grants

Valor padrão Nenhuma Aceita 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:

1. 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.
2. 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.