Actualiza las tablas de Iceberg V1 a V2

Si tienes tablas de Apache Iceberg de la versión 1 (V1) existentes, debes actualizarlas con tu motor de consultas antes de usarlas con el extremo del catálogo REST de Apache Iceberg. Para obtener más información, consulta Cómo modificar una tabla.

Antes de comenzar

  1. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

  2. Habilita la API de BigLake.

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

    Habilitar la API

  3. Configura el catálogo de tiempo de ejecución de Lakehouse con el extremo del catálogo REST de Apache Iceberg.

Roles obligatorios

Para obtener los permisos que necesitas para actualizar una tabla, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto y bucket de almacenamiento:

  • Actualizar la tabla en el modo de venta de credenciales: Editor de BigLake (roles/biglake.editor) - el proyecto
  • Actualizar la tabla en el modo de venta sin credenciales:
    • Editor de BigLake (roles/biglake.editor) - el proyecto
    • Usuario de objetos de almacenamiento (roles/storage.objectUser) - el bucket de Cloud Storage

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Actualiza una tabla

Para actualizar una tabla de Iceberg V1 a V2, ejecuta el siguiente comando en tu motor de consultas:

Spark 

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

Reemplaza lo siguiente:

  • CATALOG_NAME: el nombre de tu catálogo.
  • SCHEMA_NAME: el nombre de tu esquema.
  • TABLE_NAME: el nombre de tu tabla.

¿Qué sigue?