Atualizar um catálogo

Ao atualizar um catálogo (como um catálogo REST do Apache Iceberg), é possível modificar as propriedades dele, como modo de credencial, local padrão do data warehouse ou tipo de catálogo subjacente. Por exemplo, é possível fazer upgrade de um catálogo legado de bucket do Cloud Storage (catálogo gs://) para um catálogo do BigLake (catálogo bl://).

Antes de começar

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

  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 atualizar um catálogo, peça ao administrador que conceda a você os seguintes papéis do IAM:

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.

Atualizar um catálogo

É possível atualizar a configuração de um catálogo, como modificar a descrição, o modo de credencial ou os locais permitidos.

Além disso, é possível fazer upgrade de um catálogo de bucket do Cloud Storage (catálogo gs:// legado) para um catálogo do BigLake (catálogo bl://). O catálogo atualizado mantém o nome do bucket original. Depois do upgrade, é possível associar vários buckets e configurar locais restritos.

É possível atualizar um catálogo usando o console doGoogle Cloud , gcloud ou a API REST.

Console

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

    Acessar Lakehouse

  2. Na linha do catálogo que você quer atualizar, clique em Mais ações do catálogo > Editar.

  3. Em Configuração do catálogo, modifique as configurações que você quer atualizar.

  4. Selecione Salvar.

gcloud

Use o comando gcloud beta biglake iceberg catalogs update.

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    [--description="DESCRIPTION"] \
    [--credential-mode="CREDENTIAL_MODE"] \
    [--restricted-locations="RESTRICTED_LOCATIONS"] \
    [--catalog-type=biglake]

Substitua:

  • CATALOG_ID: o ID do catálogo do ambiente de execução do Lakehouse.
  • PROJECT_ID: o ID do projeto Google Cloud .
  • DESCRIPTION: (opcional) uma descrição do catálogo.
  • CREDENTIAL_MODE: (opcional) o método de autenticação. Use end-user para Credenciais do usuário final ou vended-credentials para Modo de venda de credenciais.
  • RESTRICTED_LOCATIONS: (opcional) uma lista separada por vírgulas de outros buckets ou caminhos de armazenamento permitidos.

REST

Para modificar um catálogo ou fazer upgrade do tipo dele usando a API REST, faça uma solicitação PATCH para o endpoint UpdateIcebergCatalog com o updateMask adequado:

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=icebergCatalog.catalogType,icebergCatalog.description

O corpo da solicitação precisa conter um payload JSON IcebergCatalog com os campos a serem atualizados:

{
  "catalogType": "BIGLAKE",
  "description": "Updated catalog description"
}

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud .
  • CATALOG_ID: o ID do catálogo do ambiente de execução do Lakehouse.