Supprimer une table

La suppression d'une table ne supprime que son enregistrement et ses métadonnées du catalogue d'environnements d'exécution Lakehouse. Les fichiers de données sous-jacents stockés dans Cloud Storage ne sont pas purgés ni supprimés.

Vous pouvez supprimer une table à l'aide de la Google Cloud console, des commandes SQL drop dans Spark et Trino, ou de l'API REST.

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 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 d'utilisation du service (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 supprimer une table, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

  • Tous : Administrateur BigLake (roles/biglake.admin) – votre projet

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 via des rôles personnalisés ou d'autres rôles prédéfinis.

Fonctionnalités et compatibilité des tables

Lorsque vous utilisez des tables dans le catalogue d'environnements d'exécution Lakehouse, il est utile de comprendre les différents types de tables et leurs fonctionnalités d'activation des fonctionnalités. Pour en savoir plus sur l'utilisation des tables Apache Iceberg, consultez Présentation des tables Apache Iceberg tables.

Tables Iceberg compatibles

Seules les tables Apache Iceberg V2 (disponibilité générale) et V3 (aperçu) sont compatibles. Les tables Iceberg V1 ne sont pas compatibles. Pour mettre à niveau des tables V1 existantes, consultez Mettre à niveau des tables Iceberg V1 vers la version V2.

Utiliser les options de table (aperçu)

Vous pouvez choisir d'utiliser les fonctionnalités gérées de BigQuery, telles que le langage de manipulation de données (LMD) BigQuery et la gestion automatique des tables, en configurant des propriétés de table spécifiques. Ces fonctionnalités sont activées de différentes manières selon l'endroit où la table est créée :

  • À partir de BigQuery : le LMD BigQuery et la gestion automatique des tables sont activés par défaut.
  • À partir de moteurs Open Source : pour activer ces fonctionnalités, vous devez configurer explicitement les propriétés de la table. Pour en savoir plus, consultez Configurer les options de table.

La suppression de l'enregistrement d'une table du catalogue supprime la table, qu'il s'agisse d'une table Iceberg standard ou d'une table activée pour les fonctionnalités gérées de BigQuery. Consultez Configurer les options de table pour comprendre comment la suppression de table interagit avec les tâches de gestion de table en arrière-plan.

Supprimer une table

Supprimer une table.

Console

  1. Dans la Google Cloud console, accédez à Lakehouse.

    Accéder à Lakehouse

  2. Sélectionnez un catalogue existant ou créez-en un si vous n'en avez pas.

  3. Dans le tableau Détails de l'espace de noms, sélectionnez une table et développez les options du menu.

  4. Cliquez sur Supprimer.

  5. Confirmez la suppression en saisissant le nom de la table dans la boîte de dialogue.

  6. Cliquez sur Supprimer.

Spark 

spark.sql("DROP TABLE TABLE_NAME;")

DROP TABLE TABLE_NAME;

gcloud

Pour supprimer une table à l'aide de gcloud, exécutez la gcloud biglake iceberg tables delete commande.

gcloud biglake iceberg tables delete TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

Remplacez les éléments suivants :

  • TABLE_NAME : nom de votre table Iceberg.
  • PROJECT_ID: ID de votre Google Cloud projet.
  • CATALOG_ID : ID de votre catalogue.
  • NAMESPACE_NAME : nom de l'espace de noms de votre catalogue.

BigQuery

Pour supprimer l'enregistrement d'une table Apache Iceberg dans le catalogue d'environnements d'exécution Lakehouse à partir de BigQuery, utilisez l'instruction GoogleSQL DROP TABLE suivante :

DROP TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`;

Remplacez les éléments suivants :

  • PROJECT_ID: ID de votre Google Cloud projet.
  • CATALOG_ID : ID de votre catalogue d'environnements d'exécution Lakehouse.
  • NAMESPACE : nom de votre espace de noms Iceberg.
  • TABLE_NAME : nom de votre table Iceberg.

REST

Pour supprimer l'enregistrement d'une table Iceberg à l'aide de l'API REST, envoyez une DELETE requête au DeleteIcebergTable point de terminaison :

DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME

Remplacez les éléments suivants :

  • PROJECT_ID: ID de votre Google Cloud projet.
  • CATALOG_ID : ID de votre catalogue.
  • NAMESPACE_NAME : nom de l'espace de noms de votre catalogue.
  • TABLE_NAME : nom de votre table Iceberg.

Étape suivante