A criação de um namespace em um catálogo (como um catálogo REST do Apache Iceberg ou do Apache Hive) ajuda a organizar as tabelas no catálogo de ambiente de execução do Lakehouse.
Antes de começar
-
Verifique se o faturamento está ativado para o Google Cloud projeto.
-
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ãoserviceusage.services.enable. Saiba como conceder papéis.
Funções exigidas
Para receber as permissões necessárias para criar um namespace, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Todos:
- Administrador do BigLake (
roles/biglake.admin) - Administrador de armazenamento (
roles/storage.admin)
- Administrador do BigLake (
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 namespace
Crie um namespace em um catálogo.
Console
No Google Cloud console do, abra a página Lakehouse.
Selecione um catálogo ou crie um, se necessário.
Na barra de menus, clique em + Criar namespace.
Em Nome do namespace, insira um nome exclusivo.
Em Local, selecione um bucket do Cloud Storage para associar ao namespace.
Clique em Criar.
O namespace será criado e vai aparecer na lista de detalhes do catálogo.
REST
Para criar um namespace usando a API REST, faça uma POST solicitação para o
CreateIcebergNamespace endpoint:
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces
O corpo da solicitação precisa conter um payload JSON CreateNamespaceRequest do Iceberg válido que defina o identificador e as propriedades do namespace.
Substitua:
PROJECT_ID: o ID do Google Cloud projeto.CATALOG_ID: o ID do catálogo de ambiente de execução do Lakehouse.