O Dataplex define vários papéis de gerenciamento de identidade e acesso (IAM). Cada papel predefinido contém um conjunto de permissões do IAM que permitem que os principais realizem determinadas ações. É possível usar uma política do IAM para conceder um ou mais papéis do IAM a um principal.
O IAM também oferece a capacidade de criar papéis personalizados. É possível criar papéis personalizados do IAM e atribuir a eles uma ou mais permissões. Em seguida, é possível conceder o novo papel a seus principais. Use papéis personalizados para criar um modelo de controle de acesso que corresponda às suas necessidades, junto com os papéis predefinidos disponíveis.
Este documento descreve os papéis do IAM relevantes para o Dataplex.
Para uma descrição detalhada do IAM e dos recursos dele, consulte a documentação do IAM.
Sobre os papéis do Dataplex
Os papéis do IAM do Dataplex são um pacote de uma ou mais
permissões. Você concede papéis aos principais para permitir que executem ações nos
recursos do Dataplex no seu projeto. Por exemplo, o papel Leitor do Dataplex contém as permissões dataplex.*.get
e dataplex.*.list
, que permitem que os usuários acessem e listem os recursos do Dataplex em um projeto. Para mais informações, consulte Permissões do Dataplex.
É possível aplicar funções do Dataplex a qualquer recurso na hierarquia de serviços, incluindo projetos, lakes e zonas de dados.
Papéis básicos
É possível atribuir papéis básicos no nível do projeto usando os papéis do Projeto do IAM. Confira a seguir a lista de permissões associadas aos papéis do Projeto do IAM:
Papel do projeto | Permissões |
---|---|
Proprietário do projeto | Todas as permissões do Editor do projeto acrescidas das permissões para gerenciar o controle de acesso do projeto (get/set IamPolicy) e configurar o faturamento do projeto |
Editor do projeto | Todas as permissões do Visualizador do projeto acrescidas de todas as permissões do projeto para ações que modificam o estado (criar, excluir, atualizar, usar, cancelar) |
Visualizador do projeto | Todas as permissões do projeto para ações somente leitura que preservam o estado (get, lista) |
Papéis predefinidos para o Dataplex
Os papéis predefinidos contêm as permissões necessárias para executar uma tarefa ou um grupo de tarefas relacionadas.
Observe o seguinte:
- Os papéis de administrador, editor e leitor do Dataplex não concedem acesso aos recursos do Dataplex Catalog.
- Nenhuma função concede permissões para adicionar ou excluir entradas do Dataplex Catalog de grupos de entrada definidos pelo sistema, como
@bigquery
e@dataplex
. - A função de proprietário de entrada do Dataplex inclui o seguinte:
- Concede acesso total a operações relacionadas à entrada.
- Concede permissões para adicionar aspectos de alguns dos tipos de aspecto do sistema,
como
Schema
,Generic
,Overview
eContacts
. - Concede permissões para criar entradas do tipo
GenericEntry
. - Com essa função, você pode criar uma entrada com um tipo de entrada e um tipo de aspecto, em que o tipo de entrada e o tipo de aspecto são definidos no mesmo projeto que a entrada. Caso contrário, outros papéis de usuário de tipo de entrada e de tipo de aspecto do Dataplex precisam ser concedidos nos projetos em que o tipo de entrada e o tipo de aspecto são definidos.
- Ao usar o método
LookupEntry
ouSearchEntries
, essa função não concede permissões para ler entradas criadas a partir de recursosGoogle Cloud fora do Dataplex, como entradas do BigQuery. Para ler essas entradas, você precisa ter permissões nos recursos do sistema de origem. Como alternativa, é possível ler as entradas com apenas a função de proprietário de entrada do Dataplex usando o métodoGetEntry
.
- Para pesquisar entradas usando o método
SearchEntries
, você precisa ter pelo menos uma das funções do IAM do Dataplex Catalog no projeto usado na solicitação da API. As permissões nos resultados da pesquisa são verificadas independentemente do projeto selecionado.
A tabela a seguir lista os papéis predefinidos do Dataplex e as permissões associadas a cada um:
Role | Permissions |
---|---|
Dataplex Administrator( Full access to Dataplex resources, except Dataplex Catalog. |
|
Dataplex Aspect Type Owner( Grants access to creating and managing Aspect Types. Does not give the right to create/modify Entries. |
|
Dataplex Aspect Type User( Grants access to use Aspect Types to create/modify Entries with the corresponding aspects. |
|
Dataplex Binding Administrator( Full access on DataAttribute Bindig resources. |
|
Dataplex Catalog Admin( Has full access to Catalog resources: Entry Groups, Entry Types, Aspect Types and Entries. |
|
Dataplex Catalog Editor( Has write access to Catalog resources: Entry Groups, Entry Types, Aspect Types and Entries. Cannot set IAM policies on resources |
|
Dataplex Catalog Viewer( Has read access to Catalog resources: Entry Groups, Entry Types, Aspect Types and Entries. Can view IAM policies on Catalog resources. |
|
Dataplex Data Owner( Owner access to data. To be granted to Dataplex resources Lake, Zone or Asset only. |
|
Dataplex Data Reader( Read only access to data. To be granted to Dataplex resources Lake, Zone or Asset only. |
|
Dataplex DataScan Administrator( Full access to DataScan resources. |
|
Dataplex DataScan Creator( Access to create new DataScan resources. |
|
Dataplex DataScan DataViewer( Read access to DataScan resources and additional contents. |
|
Dataplex DataScan Editor( Write access to DataScan resources. |
|
Dataplex DataScan Viewer( Read access to DataScan resources. |
|
Dataplex Data Writer( Write access to data. To be granted to Dataplex resources Lake, Zone or Asset only. |
|
Dataplex Developer( Allows running data analytics workloads in a lake. |
|
Dataplex Editor( Write access to Dataplex resources. |
|
Dataplex Encryption Admin( Gives user permissions to manage encryption config. |
|
Dataplex Entry Group Exporter Beta( Grants access to export this entry group for Metadata Job processing. |
|
Dataplex Entry Group Importer( Grants access to import this entry group for Metadata Job processing. |
|
Dataplex Entry Group Owner( Owns Entry Groups and Entries inside of them. |
|
Dataplex Entry Owner( Owns Metadata Entries. |
|
Dataplex Entry Type Owner( Grants access to creating and managing Entry Types. Does not give the right to create/modify Entries. |
|
Dataplex Entry Type User( Grants access to use Entry Types to create/modify Entries of those types. |
|
Dataplex Metadata Job Owner( Grants access to creating and managing Metadata Jobs. Does not give the right to create/modify Entry Groups. |
|
Dataplex Metadata Job Viewer( Read access to Metadata Job resources. |
|
Dataplex Metadata Reader( Read only access to metadata. |
|
Dataplex Metadata Writer( Write and Read access to metadata. |
|
Dataplex Security Administrator( Permissions configure ResourceAccess and DataAccess Specs on Data Attributes. |
|
Dataplex Storage Data Owner( Owner access to data. Should not be used directly. This role is granted by Dataplex to managed resources like Cloud Storage buckets, BigQuery datasets etc. |
|
Dataplex Storage Data Reader( Read only access to data. Should not be used directly. This role is granted by Dataplex to managed resources like Cloud Storage buckets, BigQuery datasets etc. |
|
Dataplex Storage Data Writer( Write access to data. Should not be used directly. This role is granted by Dataplex to managed resources like Cloud Storage buckets, BigQuery datasets etc. |
|
Dataplex Taxonomy Administrator( Full access to DataTaxonomy, DataAttribute resources. |
|
Dataplex Taxonomy Viewer( Read access on DataTaxonomy, DataAttribute resources. |
|
Dataplex Viewer( Read access to Dataplex resources. |
|
Papéis predefinidos para a linhagem de dados
Para acessar a linhagem de qualquer entrada do Dataplex Catalog, você precisa
ter acesso à entrada no Dataplex. Para acessar a
entrada do Dataplex Catalog, você precisa de uma função de leitor no
recurso do sistema correspondente ou a
função de leitor do Dataplex Catalog
(roles/dataplex.catalogViewer
) no projeto que armazena a
entrada do Dataplex Catalog. Esta seção descreve os papéis necessários para
visualizar a linhagem.
Papel de leitor de linhagem
O papel de leitor de linhagem de dados
(roles/datalineage.viewer
) permite visualizar a linhagem do Dataplex
no console do Google Cloud e ler informações de linhagem usando
a API Data Lineage. As
execuções e os eventos de um determinado processo são armazenados no mesmo projeto que o
processo. No caso da linhagem automatizada,
o processo, as execuções e os eventos
são armazenados no projeto em que o job que gerou a linhagem estava
em execução. Por exemplo, o projeto em que um job do BigQuery estava sendo executado.
Você precisa de diferentes funções para conferir a linhagem entre os recursos e os metadados
deles. Para o primeiro, você precisa do papel de leitor de linhagem de dados (roles/datalineage.viewer
).
Para o segundo, você precisa das mesmas funções usadas para acessar entradas de metadados no Dataplex.
Funções para conferir a linhagem entre dois recursos
Para conferir a linhagem entre os recursos, você precisa da
função de leitor da linhagem de dados (roles/datalineage.viewer
)
nos seguintes projetos:
- O projeto em que você está visualizando a linhagem (conhecido como projeto ativo), ou seja, o projeto no menu suspenso na parte de cima do console do Google Cloud ou o projeto em que as chamadas de API são feitas. Normalmente, é o projeto que contém os recursos que você vai criar no catálogo do Dataplex ou acessar em outros sistemas Google Cloud com a API.
- Os projetos em que a linhagem é registrada (conhecidos como projeto de computação). A linhagem é armazenada no projeto em que o processo correspondente foi executado, conforme descrito anteriormente. Esse projeto pode ser diferente do projeto que armazena o recurso para o qual você está visualizando a linhagem.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso. Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
Dependendo do caso de uso, conceda o papel de leitor de linhagem de dados (roles/datalineage.viewer
)
no nível da pasta ou da organização para garantir o acesso à linhagem (consulte Conceder ou revogar um único papel).
Os papéis necessários para a linhagem de dados só podem ser concedidos pela
CLI do Google Cloud.
Funções para conferir metadados de recursos ao visualizar a linhagem
Quando os metadados de um recurso são armazenados no Dataplex Catalog, você só
pode acessar esses metadados se tiver uma função de leitor no
recurso do sistema correspondente
ou a função de leitor do Dataplex Catalog (roles/dataplex.catalogViewer
)
no projeto em que a entrada do Dataplex Catalog está armazenada. Você
pode ter acesso a recursos na lista ou no gráfico de linhagem usando as funções de visualização
adequadas, mas não tem acesso à linhagem entre eles. Isso acontece quando
você não tem o papel de leitor da linhagem de dados (roles/datalineage.viewer
)
no projeto em que a linhagem foi gravada. Nesse caso, a API Data Lineage e o console do Google Cloud não mostram a linhagem nem retornam um erro para evitar o vazamento de informações sobre a existência da linhagem. Portanto, a ausência de linhagem para um recurso não significa que não há
uma linhagem para esse recurso, mas que você não tem acesso a ela.
Função de produtor de eventos da linhagem de dados
A função Produtor de eventos da linhagem de dados
(roles/datalineage.producer
) permite que os usuários registrem manualmente as informações da linhagem
usando a API Data Lineage.
Função de editor da linhagem de dados
A função de editor da linhagem de dados
(roles/datalineage.editor
) permite que os usuários modifiquem manualmente as informações
da linhagem usando a API Data Lineage.
Função de administrador da linhagem de dados
O papel de administrador de linhagem de dados
(roles/datalineage.admin
) permite que os usuários realizem todas as operações de linhagem
listadas nesta seção.
Papéis de dados
O Dataplex define os seguintes papéis do IAM, que são aplicados a qualquer recurso gerenciado pelo Dataplex. Para mais informações sobre as permissões associadas a cada função, consulte a seção Papéis predefinidos deste documento.
Função de dados | Recursos | Motivo |
---|---|---|
Proprietário de dados do Dataplex (roles/dataplex.dataOwner ) |
Todas as permissões no recurso gerenciado. E todas as permissões em todos os recursos filhos, independentemente do tipo. | Os proprietários de dados podem atualizar metadados de recursos, conceder permissões de granularidade mais alta (por exemplo, em tabelas filhas de um conjunto de dados do BigQuery) e criar recursos filhos, além de várias outras permissões. Eles têm a propriedade total do recurso. |
Leitor de dados do Dataplex (roles/dataplex.dataReader ) |
Capacidade de ler dados no recurso gerenciado e nos filhos dele. E a capacidade de ler os metadados do recurso gerenciado e dos filhos dele. | Permite ler dados e metadados. |
Gravador de dados do Dataplex (roles/dataplex.dataWriter ) |
Capacidade de criar/atualizar/excluir dados (não metadados). | Ativa as principais jornadas do usuário do Dataplex. |
A seguir
- Saiba como criar papéis personalizados.
- Saiba como conceder e gerenciar papéis.
- Consulte o Mapeamento de permissões do IAM do Dataplex.