Fazer upgrade das tabelas do Iceberg V1 para V2

Se você tiver tabelas do Apache Iceberg versão 1 (V1), faça upgrade delas usando o mecanismo de consulta antes de usá-las com o endpoint do catálogo REST do Apache Iceberg. Para mais informações, consulte Alterar uma tabela.

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

  3. Configure o catálogo de ambiente de execução do Lakehouse com o endpoint do catálogo REST do Apache Iceberg.

Funções exigidas

Para ter as permissões necessárias para fazer upgrade de uma tabela, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto e no bucket de armazenamento:

  • Fazer upgrade da tabela no modo de fornecimento de credenciais: editor do BigLake (roles/biglake.editor) – o projeto
  • Fazer upgrade da tabela no modo de não fornecimento de credenciais:
    • Editor do BigLake (roles/biglake.editor) – o projeto
    • Usuário de objetos do Storage (roles/storage.objectUser) – o bucket do Cloud Storage

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 com papéis personalizados ou outros papéis predefinidos.

Fazer upgrade de uma tabela

Para fazer upgrade de uma tabela do Iceberg V1 para V2, execute o seguinte comando no mecanismo de consulta:

Spark 

ALTER TABLE CATALOG_NAME.SCHEMA_NAME.TABLE_NAME SET TBLPROPERTIES ('format-version'='2');

Substitua:

  • CATALOG_NAME: o nome do catálogo.
  • SCHEMA_NAME: o nome do esquema.
  • TABLE_NAME: o nome da tabela.

A seguir