Tabelle löschen

Wenn Sie eine Tabelle löschen oder entfernen, werden 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 -Konsole, mit SQL-Drop-Befehlen in Spark und Trino oder über die REST API löschen.

Hinweis

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

  2. Aktivieren Sie die BigLake API, falls sie noch nicht aktiviert ist.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

    API aktivieren

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

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:

  • Tabelle löschen: 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 ‑unterstützung

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

Unterstützte Iceberg-Tabellen

Es werden nur Apache Iceberg-Tabellen der Version 2 (GA) und Version 3 (Vorschau) unterstützt. Iceberg V1-Tabellen werden nicht unterstützt. Informationen zum Aktualisieren vorhandener V1-Tabellen finden Sie unter Iceberg-V1-Tabellen auf V2 aktualisieren.

Tabellenoptionen verwenden (Vorabversion)

Sie können die verwalteten BigQuery-Funktionen wie die BigQuery-Datenbearbeitungssprache (DML) und die automatische Tabellenverwaltung aktivieren, indem Sie bestimmte Tabelleneigenschaften konfigurieren. Diese Funktionen werden je nach Ort, an dem die Tabelle erstellt wird, unterschiedlich aktiviert:

  • Aus BigQuery:BigQuery-DML und die automatische Tabellenverwaltung sind standardmäßig aktiviert.
  • Von Open-Source-Engines:Wenn Sie diese Option aktivieren möchten, müssen Sie 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, die für verwaltete BigQuery-Funktionen aktiviert ist. 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 Sie noch keinen haben.

  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 das Löschen, 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

Wenn Sie eine Tabelle mit gcloud löschen möchten, führen Sie den Befehl gcloud biglake iceberg tables delete aus.

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: Projekt-ID in Google Cloud .
  • CATALOG_ID: Die ID Ihres Katalogs.
  • NAMESPACE_NAME: Der Name Ihres Katalognamespace.

BigQuery

Wenn Sie die Registrierung einer Apache Iceberg-Tabelle im Lakehouse-Laufzeitkatalog aus BigQuery löschen möchten, verwenden Sie die folgende GoogleSQL-DROP TABLE-Anweisung:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • CATALOG_ID: Ihre Lakehouse-Laufzeitkatalog-ID.
  • NAMESPACE: Der Name Ihres Iceberg-Namespace.
  • TABLE_NAME: Der Name Ihrer Iceberg-Tabelle.

REST

Wenn Sie die Registrierung einer Iceberg-Tabelle mit der REST API löschen möchten, senden Sie eine DELETE-Anfrage an den Endpunkt DeleteIcebergTable:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • CATALOG_ID: Die ID Ihres Katalogs.
  • NAMESPACE_NAME: Der Name Ihres Katalognamespace.
  • TABLE_NAME: Der Name Ihrer Iceberg-Tabelle.

Nächste Schritte