Criar um catálogo

A criação de um catálogo REST do Apache Iceberg no Google Cloud console estabelece um endpoint de gerenciamento no catálogo do ambiente de execução do Lakehouse. Esse endpoint aponta para um bucket de data warehouse do Cloud Storage subjacente, fornecendo uma camada de metadados que permite que vários mecanismos de consulta interajam diretamente com seus formatos de tabela aberta.

Ao criar o catálogo do Lakehouse para Apache Iceberg, é possível escolher entre as credenciais do usuário final ou o modo de distribuição de credenciais para delegação de acesso ao armazenamento.

Antes de começar

  1. Verifique se o faturamento está ativado para o Google Cloud projeto.

  2. Ative a API BigLake.

    Funções necessárias para ativar APIs

    Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

    Ativar a API

Funções exigidas

Para receber as permissões necessárias para criar um catálogo no Google Cloud console, peça ao administrador para conceder a você os seguintes papéis do IAM 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 personalizados papéis ou outros predefinidos papéis.

Criar um catálogo

  1. No Google Cloud console do Google Cloud, abra a página Lakehouse.

    Acesse Lakehouse

  2. Clique em Criar catálogo. A página Criar catálogo será aberta.

  3. Em Selecionar um bucket do Cloud Storage, insira o nome do bucket do Cloud Storage que será usado com o catálogo. Como alternativa, clique em Procurar para escolher em uma lista de buckets atuais ou criar um novo. Só é possível ter um catálogo por bucket do Cloud Storage.

  4. Em Método de autenticação, selecione Credenciais do usuário final ou Modo de distribuição de credenciais.

  5. Clique em Criar.

    O catálogo será criado e a página Detalhes do catálogo será aberta.

  6. Em Método de autenticação, clique em Definir permissões do bucket.

  7. Na caixa de diálogo, clique em Confirmar.

    Isso verifica se a conta de serviço do catálogo tem o papel Usuário de objetos do Storage no bucket de armazenamento.