required_access_grants

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âmetro required_access_grants (para "explores").

required_access_grants também pode fazer parte de uma mesclagem, descrita na página de documentação do parâmetro required_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âmetro required_access_grants (para visualizações).

Uso

view: view_name {
dimensão: field_name {
required_access_grants: [access_grant_name, access_grant_name, ...]
}
}

Hierarquia Ver arquivo view Tipo de campo required_access_grants

Tipos de campo possíveis Dimensão, grupo de dimensões, medir, filtro, parâmetro Aceita 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:

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