Tabelle löschen

Wenn Sie eine Tabelle löschen oder entfernen, wird nur die Tabellenregistrierung und die Metadaten aus dem Lakehouse-Laufzeitkatalog entfernt. Die zugrunde liegenden Datendateien, die in Cloud Storage gespeichert sind, werden nicht gelöscht.

Sie können eine Tabelle über die Google Cloud Console, mit SQL-Löschbefehlen in Spark und Trino oder mit der REST API löschen.

Hinweis

  1. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

  2. Aktivieren Sie die BigLake API.

    Erforderliche Rollen zum Aktivieren von APIs

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Informationen zum Zuweisen von Rollen.

    API aktivieren

  3. Richten Sie den Lakehouse-Laufzeitkatalog ein mit dem Apache Iceberg REST-Katalogendpunkt.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Löschen einer Tabelle haben:

  • Alle: BigLake-Administrator (roles/biglake.admin) – Ihr Projekt

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Tabellenfunktionen und -support

Wenn Sie Tabellen im Lakehouse-Laufzeitkatalog verwenden, ist es hilfreich, die verschiedenen Tabellentypen und ihre optionalen Funktionen zu verstehen . Weitere Informationen zur Verwendung von Apache Iceberg-Tabellen finden Sie unter Übersicht über Apache Iceberg Tabellen.

Unterstützte Iceberg-Tabellen

Nur Apache Iceberg V2 (allgemeine Verfügbarkeit) und V3 (Vorschau) werden unterstützt. Iceberg V1-Tabellen werden nicht unterstützt. Informationen zum Upgrade vorhandener V1-Tabellen finden Sie unter Iceberg V1 Tabellen auf V2 aktualisieren.

Tabellenoptionen verwenden (Vorschau)

Sie können bestimmte Tabelleneigenschaften konfigurieren, um verwaltete BigQuery-Funktionen wie die BigQuery-Datenbearbeitungssprache (DML) und die automatische Tabellenverwaltung zu verwenden. Diese Funktionen werden je nach Erstellungsort der Tabelle unterschiedlich aktiviert:

  • Aus BigQuery:BigQuery DML und die automatische Tabellenverwaltung sind standardmäßig aktiviert.
  • Aus Open-Source-Engines:Wenn Sie diese Funktionen verwenden möchten, müssen Sie die Tabelleneigenschaften explizit konfigurieren. Weitere Informationen finden Sie unter Tabellenoptionen konfigurieren.

Wenn Sie eine Tabellenregistrierung aus dem Katalog löschen, wird die Tabelle entfernt, unabhängig davon, ob es sich um eine Standard-Iceberg-Tabelle oder eine Tabelle handelt, für die verwaltete BigQuery-Funktionen aktiviert sind. Unter Tabellenoptionen konfigurieren erfahren Sie, wie sich das Löschen von Tabellen auf Hintergrundjobs zur Tabellenverwaltung auswirkt.

Tabelle löschen

Eine Tabelle löschen

Console

  1. Rufen Sie in der Google Cloud Console Lakehouse auf.

    Lakehouse aufrufen

  2. Wählen Sie einen vorhandenen Katalog aus oder erstellen Sie einen, falls noch keiner vorhanden ist.

  3. Wählen Sie in der Tabelle Namespace-Details eine Tabelle aus und maximieren Sie die Menüoptionen.

  4. Klicken Sie auf Löschen.

  5. Bestätigen Sie den Löschvorgang, indem Sie den Tabellennamen in das Dialogfeld eingeben.

  6. Klicken Sie auf Löschen.

Spark 

spark.sql("DROP TABLE TABLE_NAME;")

DROP TABLE TABLE_NAME;

gcloud

Führen Sie den gcloud biglake iceberg tables delete Befehl aus, um eine Tabelle mit gcloud zu löschen.

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

Ersetzen Sie Folgendes:

  • TABLE_NAME: der Name Ihrer Iceberg-Tabelle.
  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • CATALOG_ID: die ID Ihres Katalogs.
  • NAMESPACE_NAME: der Name Ihres Katalognamespace.

BigQuery

Verwenden Sie die folgende GoogleSQL-Anweisung DROP TABLE, um die Registrierung einer Apache Iceberg-Tabelle im Lakehouse-Laufzeitkatalog aus BigQuery zu löschen:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • CATALOG_ID: die ID Ihres Lakehouse-Laufzeitkatalogs.
  • NAMESPACE: der Name Ihres Iceberg-Namespace.
  • TABLE_NAME: der Name Ihrer Iceberg-Tabelle.

REST

Senden Sie eine DELETEAnfrage an den DeleteIcebergTable Endpunkt, um die Registrierung einer Iceberg-Tabelle mit der REST API zu löschen:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • CATALOG_ID: die ID Ihres Katalogs.
  • NAMESPACE_NAME: der Name Ihres Katalognamespace.
  • TABLE_NAME: der Name Ihrer Iceberg-Tabelle.

Nächste Schritte