Mettre à niveau les tables Iceberg V1 vers V2

Si vous disposez de tables Apache Iceberg version 1 (V1) existantes, vous devez les mettre à niveau à l'aide de votre moteur de requête avant de les utiliser avec le point de terminaison du catalogue REST Apache Iceberg. Pour en savoir plus, consultez Modifier une table.

Avant de commencer

  1. Vérifiez que la facturation est activée pour votre Google Cloud projet.

  2. Activez l'API BigLake.

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

    Activer l'API

  3. Configurez le catalogue d'exécution Lakehouse avec le point de terminaison du catalogue REST Apache Iceberg.

Rôles requis

Pour obtenir les autorisations nécessaires pour mettre à niveau une table, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet et votre bucket de stockage :

  • Mettre à niveau une table en mode de distribution d'identifiants: Éditeur BigLake (roles/biglake.editor) : le projet
  • Mettre à niveau une table en mode sans distribution d'identifiants :
    • Éditeur BigLake (roles/biglake.editor) : le projet
    • Utilisateur d'objets Storage (roles/storage.objectUser) : le bucket Cloud Storage

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Mettre à niveau une table

Pour mettre à niveau une table Iceberg V1 vers la version V2, exécutez la commande suivante dans votre moteur de requête :

Spark 

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

Remplacez les éléments suivants :

  • CATALOG_NAME : nom de votre catalogue.
  • SCHEMA_NAME : nom de votre schéma.
  • TABLE_NAME : nom de votre table.

Étape suivante