Mettre à niveau les tables Iceberg V1 vers la 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 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 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 des API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le 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 la table en mode de distribution des identifiants : Éditeur BigLake (roles/biglake.editor) - le projet
  • Tableau de mise à niveau en mode de distribution sans identifiants :
    • Éditeur BigLake (roles/biglake.editor) : le projet
    • Utilisateur d'objets Storage (roles/storage.objectUser) : sur 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