Mettre à niveau les tables Iceberg V1 vers V2

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

Avant de commencer

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

  2. Activez l'API BigLake si ce n'est pas déjà fait.

    Rôles requis pour activer les API

    Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

    Activer l'API

  3. Configurez le catalogue d'environnements 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 distribution d'identifiants : Éditeur BigLake (roles/biglake.editor) : projet
  • Table de mise à niveau en mode sans distribution d'identifiants :
    • Éditeur BigLake (roles/biglake.editor) : 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.

Étapes suivantes