O Lakehouse sem fronteiras oferece suporte ao controle de acesso no nível do catálogo, do namespace e da tabela para tabelas do Apache Iceberg no Cloud Storage que usam o catálogo do ambiente de execução do Lakehouse.
O catálogo do ambiente de execução do Lakehouse gerencia os metadados, enquanto as políticas do Identity and Access Management (IAM) definem as permissões. Use o Google Cloud console ou a Google Cloud CLI para receber e definir essas políticas do IAM. Para restringir o acesso a linhas específicas ou mascarar colunas sensíveis em tabelas do Apache Iceberg, consulte Segurança no nível da linha e da coluna.
Antes de começar
-
Verifique se o faturamento está ativado para o projeto do Google Cloud .
-
Ative a API BigLake, se ainda não tiver feito isso.
Funções necessárias para ativar APIs
Para ativar APIs, você precisa da permissão
serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis. - Instale e inicialize a CLI gcloud.
- Verifique se você tem um endpoint e um namespace do catálogo REST do Apache Iceberg.
- Verifique se você tem uma tabela do Apache Iceberg gerenciada pelo Lakehouse no catálogo e no namespace especificados.
Funções exigidas
Para receber as permissões necessárias para gerenciar listas de controle de acesso (ACLs) para catálogos, namespaces e tabelas do Iceberg, peça ao administrador para conceder a você os seguintes papéis do IAM:
-
Todos:
Administrador do BigLake (
roles/biglake.admin) no projeto
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.
Como funciona
As políticas do IAM definem quais principais têm papéis e permissões específicos para um recurso. Para gerenciar o acesso aos recursos, receba e defina essas políticas.
Escopo dos papéis do IAM
É possível conceder papéis do IAM em diferentes níveis da hierarquia de recursos:
- Nível do projeto: concede acesso a todos os recursos do Lakehouse no projeto.
- Nível do catálogo: concede acesso aos recursos que pertencem ao catálogo especificado.
- Nível de namespace: concede acesso aos recursos que pertencem ao namespace especificado.
- Nível da tabela: concede acesso apenas à tabela especificada.
Papéis relevantes do IAM
A lista a seguir mostra alguns dos papéis comuns do IAM que podem ser aplicados aos recursos do Lakehouse. Para uma lista completa dos papéis disponíveis e as permissões associadas, consulte Papéis do IAM do Lakehouse.
roles/biglake.admin: fornece acesso total a todos os recursos do Lakehouse.roles/biglake.editor: fornece acesso de leitura e gravação a todos os recursos do Lakehouse.roles/biglake.viewer: fornece acesso somente leitura a todos os recursos do Lakehouse.roles/biglake.metadataViewer: fornece acesso de metadados somente leitura a todos os recursos do Lakehouse.
Práticas recomendadas
- Privilégio mínimo: conceda apenas as permissões necessárias aos usuários e às contas de serviço.
- Use etags: sempre inclua o campo
etagde um comandoget-iam-policyrecente no arquivo de política ao executar o comandoset-iam-policypara evitar substituições não intencionais. - Geração de registros de auditoria: ative os Registros de auditoria do Cloud para acompanhar as mudanças nas políticas do IAM.
- Controle de versões: armazene os arquivos de política em um sistema de controle de versões.
Aplicar papéis de ACL a catálogos
A seção a seguir mostra como aplicar ACLs a catálogos.
gcloud
Receber a política do IAM
Para conferir a política atual do IAM em um catálogo no
catálogo do ambiente de execução do Lakehouse, use o comando
gcloud biglake iceberg
catalogs get-iam-policy.
Para receber a política do IAM, execute o seguinte comando:
gcloud biglake iceberg catalogs get-iam-policy CATALOG_NAME \ --project=PROJECT_IDSubstitua:
CATALOG_NAME: o nome do catálogo.PROJECT_ID: o ID do projeto do Google Cloud.
A resposta ao comando gera a política do IAM no formato YAML, que mostra as vinculações de papéis e os membros atuais.
Definir a política do IAM
Para atualizar a política do IAM em um catálogo no
catálogo do ambiente de execução do Lakehouse, use o comando gcloud biglake iceberg catalogs set-iam-policy.
Esse comando usa um arquivo JSON ou YAML local que contém a política que você quer
aplicar.
Crie um arquivo de política local no formato JSON ou YAML. O arquivo de política precisa conter as vinculações e um
etag. O valoretagfornece controle de simultaneidade otimista para evitar a substituição de alterações. Para ver oetagatual, execute o comandoget-iam-policyprimeiro.O exemplo a seguir mostra um arquivo de política chamado
policy.json:{ "bindings": [ { "role": "roles/biglake.viewer", "members": [ "user:test-user@example.com" ] }, { "role": "roles/biglake.editor", "members": [ "user:someone@example.com" ] } ], "etag": "BwYXa9UuR8w=", "version": 3 }Para definir a política do IAM, execute o seguinte comando:
gcloud biglake iceberg catalogs set-iam-policy CATALOG_NAME POLICY_FILE \ --project=PROJECT_IDSubstitua:
CATALOG_NAME: o nome do endpoint do catálogo REST do Apache Iceberg.POLICY_FILE: o caminho para o arquivo de política local.PROJECT_ID: o ID do projeto do Google Cloud .
Aplicar papéis de ACL a namespaces
A seção a seguir mostra como aplicar ACLs a namespaces.
O console do Google Cloud não exibe nem gerencia políticas herdadas do IAM.
Console
No console do Google Cloud , abra a página Lakehouse.
Selecione um catálogo ou crie um, se não tiver.
Na tabela Detalhes do namespace, selecione um namespace e expanda as opções do menu ().
Clique em Gerenciar permissões.
A caixa de diálogo Permissões de compartilhamento é exibida.
Clique em Adicionar principal.
No campo Novos principais, insira a conta principal a que você quer atribuir papéis.
Em Selecionar um papel, escolha um papel para atribuir à conta principal.
Clique em Salvar.
Clique em Fechar.
gcloud
Receber a política do IAM
Para conferir a política do IAM atual em um namespace do Apache Iceberg
no Lakehouse, use o comando
gcloud biglake iceberg namespaces
get-iam-policy.
Para receber a política do IAM, execute o seguinte comando:
gcloud biglake iceberg namespaces get-iam-policy NAMESPACE_NAME \ --catalog=CATALOG_NAME \ --project=PROJECT_IDSubstitua:
NAMESPACE_NAME: o nome do namespace de destino no catálogo.CATALOG_NAME: o nome do catálogo.PROJECT_ID: o ID do projeto do Google Cloud.
A resposta ao comando gera a política do IAM no formato YAML, que mostra as vinculações de papéis e os membros atuais.
Definir a política do IAM
Para atualizar a política do IAM em um namespace do Apache Iceberg no
Lakehouse, use o comando gcloud biglake iceberg namespaces set-iam-policy.
Esse comando usa um arquivo JSON ou YAML local que contém a política que você quer
aplicar.
Crie um arquivo de política local no formato JSON ou YAML. O arquivo de política precisa conter as vinculações e um
etag. O valoretagfornece controle de simultaneidade otimista para evitar a substituição de alterações. Para ver oetagatual, execute o comandoget-iam-policyprimeiro.O exemplo a seguir mostra um arquivo de política chamado
policy.json:{ "bindings": [ { "role": "roles/biglake.viewer", "members": [ "user:test-user@example.com" ] }, { "role": "roles/biglake.editor", "members": [ "user:someone@example.com" ] } ], "etag": "BwYXa9UuR8w=", "version": 3 }Para definir a política do IAM, execute o seguinte comando:
gcloud biglake iceberg namespaces set-iam-policy NAMESPACE_NAME POLICY_FILE \ --catalog=CATALOG_NAME \ --project=PROJECT_IDSubstitua:
NAMESPACE_NAME: o nome do namespace de destino no catálogo.POLICY_FILE: o caminho para o arquivo de política local.CATALOG_NAME: o nome do endpoint do catálogo REST do Apache Iceberg.PROJECT_ID: o ID do projeto do Google Cloud .
Aplicar papéis de ACL a tabelas
A seção a seguir mostra como aplicar ACLs a tabelas.
O console do Google Cloud não exibe nem gerencia políticas herdadas do IAM.
Console
No console do Google Cloud , abra a página Lakehouse.
Selecione um catálogo ou crie um, se não tiver.
Na tabela Detalhes do namespace, clique no nome do namespace que contém sua tabela.
Na página Detalhes da tabela, selecione uma tabela e expanda as opções do menu ().
Clique em Gerenciar permissões.
A caixa de diálogo Permissões de compartilhamento é exibida.
Clique em Adicionar principal.
No campo Novos principais, insira a conta principal a que você quer atribuir papéis.
Em Selecionar um papel, escolha um papel para atribuir à conta principal.
Clique em Salvar.
Clique em Fechar.
gcloud
Receber a política do IAM
Para visualizar a política atual do IAM em uma tabela do Apache Iceberg
gerenciada pelo catálogo do ambiente de execução do Lakehouse, use o comando
gcloud biglake iceberg tables
get-iam-policy.
Para receber a política do IAM, execute o seguinte comando:
gcloud biglake iceberg tables get-iam-policy TABLE_NAME \ --catalog=CATALOG_NAME \ --namespace=NAMESPACE_NAME \ --project=PROJECT_IDSubstitua:
TABLE_NAME: o nome da tabela de destino do Apache Iceberg.CATALOG_NAME: o nome do catálogo.NAMESPACE_NAME: o nome do namespace no catálogo.PROJECT_ID: o ID do projeto do Google Cloud.
A resposta ao comando gera a política do IAM no formato YAML, que mostra as vinculações de papéis e os membros atuais.
Definir a política do IAM
Para atualizar a política do IAM em uma tabela do Apache Iceberg gerenciada
pelo catálogo do ambiente de execução do Lakehouse, use o comando gcloud biglake iceberg tables
set-iam-policy.
Esse comando usa um arquivo JSON ou YAML local que contém a política que você quer
aplicar.
Crie um arquivo de política local no formato JSON ou YAML. O arquivo de política precisa conter as vinculações e um
etag. O valoretagfornece controle de simultaneidade otimista para evitar a substituição de alterações. Para ver oetagatual, execute o comandoget-iam-policyprimeiro.O exemplo a seguir mostra um arquivo de política chamado
policy.json:{ "bindings": [ { "role": "roles/biglake.viewer", "members": [ "user:test-user@example.com" ] }, { "role": "roles/biglake.editor", "members": [ "user:someone@example.com" ] } ], "etag": "BwYXa9UuR8w=", "version": 3 }Para definir a política do IAM, execute o seguinte comando:
gcloud biglake iceberg tables set-iam-policy TABLE_NAME POLICY_FILE \ --catalog=CATALOG_NAME \ --namespace=NAMESPACE_NAME \ --project=PROJECT_IDSubstitua:
TABLE_NAME: o nome da tabela de destino do Apache Iceberg.POLICY_FILE: o caminho para o arquivo de política local.CATALOG_NAME: o nome do endpoint do catálogo REST do Apache Iceberg.NAMESPACE_NAME: o nome do namespace no catálogo.PROJECT_ID: o ID do projeto do Google Cloud .
A seguir
- Saiba como configurar a segurança no nível da linha e da coluna.
- Aprenda mais sobre o IAM.
- Confira a lista completa de papéis e permissões do IAM do Lakehouse.
- Saiba mais sobre os conceitos do Lakehouse.