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 REST-Clients können Tabellen-IDs direkt über die Open-Source-Iceberg-REST-Catalog-API-Spezifikation abrufen (GET /v1/{prefix}/namespaces/{namespace}/tables).

Hinweis

In der Tabellenübersicht finden Sie Informationen zu den verschiedenen Arten von Tabellen und den Auswirkungen ihrer Verwendung.

  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. Weitere Informationen zum Zuweisen von Rollen.

    API aktivieren

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die zum Auflisten von Tabellen erforderlich sind:

  • Alle: 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.

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()

Trino 

SHOW TABLES;

REST

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

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: die ID Ihres Lakehouse-Laufzeitkatalogs.
  • NAMESPACE_NAME: der Name Ihres Katalognamespaces.

Nächste Schritte