Tabellen auflisten

Wenn Sie Tabellen auflisten, können Sie alle registrierten Tabellenentitäten in einem Namespace im Lakehouse-Laufzeitkatalog ansehen.

Abfrage-Engines können Tabellen mit Standard-SQL-Befehlen auflisten und Sie können Tabellen-IDs mit der REST API abrufen.

Hinweis

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

  2. Aktivieren Sie die BigLake API.

    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 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 Auflisten von Tabellen haben:

  • Tabellen auflisten: BigLake-Betrachter (roles/biglake.viewer) – 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 kennen. Weitere Informationen zur Verwendung von Apache Iceberg-Tabellen finden Sie unter Übersicht über Apache Iceberg-Tabellen.

Unterstützte Iceberg-Tabellen

Nur Apache Iceberg V2-Tabellen (GA) und V3-Tabellen (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.

Tabellen auflisten

Tabellen auflisten

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.

Ihre Tabellen werden auf der Seite Namespace-Details angezeigt.

Spark 

spark.sql("SHOW TABLES").show()

Fügen Sie die Eigenschaften der Klausel TBLPROPERTIES hinzu, um die Lese-/Schreibinteroperabilität und die Tabellenverwaltung (Vorschau) zu aktivieren:

TBLPROPERTIES (
  'gcp.biglake.bigquery-dml.enabled' = true,
  'gcp.biglake.table-management.enabled' = true
)

Trino 

SHOW TABLES;

Fügen Sie diese Eigenschaften der Klausel WITH hinzu, um die Lese-/Schreibinteroperabilität und die Tabellenverwaltung (Vorschau) zu aktivieren:

WITH (
  "gcp.biglake.bigquery-dml.enabled" = 'true',
  "gcp.biglake.table-management.enabled" = 'true'
)

gcloud

Führen Sie den Befehl gcloud biglake iceberg tables list aus, um Tabellen mit gcloud aufzulisten.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • CATALOG_ID: ID Ihres Katalogs.
  • NAMESPACE_NAME: Name Ihres Katalognamespaces.

BigQuery

Wenn Sie Apache Iceberg-Tabellen im Lakehouse-Laufzeitkatalog aus BigQuery auflisten möchten, können Sie den Bereich Explorer in der BigQuery-Konsole verwenden oder den Befehl bq ls ausführen.

REST

Wenn Sie Tabellen-IDs in einem Namespace mit der REST API auflisten möchten, senden Sie eine GET Anfrage an den ListIcebergTableIdentifiers Endpunkt:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables

Die Antwort enthält ein JSON-Array mit Tabellen-IDs, die unter dem angegebenen Namespace registriert sind.

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • CATALOG_ID: ID Ihres Katalogs.
  • NAMESPACE_NAME: Name Ihres Katalognamespaces.

Nächste Schritte