Wenn Sie Tabellen auflisten, können Sie alle registrierten Tabellenentitäten in einem Namespace im Lakehouse-Laufzeitkatalog ansehen.
Mit Abfrage-Engines können Tabellen mit Standard-SQL-Befehlen aufgelistet werden. Tabellenkennungen können über die REST API abgerufen werden.
Hinweis
-
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.
-
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 - 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 Auflisten von Tabellen haben:
-
Tabellen auflisten:
BigLake Viewer (
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 ‑unterstützung
Wenn Sie Tabellen im Lakehouse-Laufzeitkatalog verwenden, ist es hilfreich, den Unterschied zwischen den Tabellentypen 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.
Tabellen auflisten
Tabellen auflisten
Console
Rufen Sie in der Google Cloud Console Lakehouse auf.
Wählen Sie einen vorhandenen Katalog aus oder erstellen Sie einen, falls Sie noch keinen haben.
Ihre Tabellen werden auf der Seite Namespace-Details angezeigt.
Spark
spark.sql("SHOW TABLES").show()
Wenn Sie die Lese-/Schreib-Interoperabilität und Tabellenverwaltung (Vorabversion) aktivieren möchten, fügen Sie die Attribute der TBLPROPERTIES-Klausel hinzu:
TBLPROPERTIES (
'gcp.biglake.bigquery-dml.enabled' = true,
'gcp.biglake.table-management.enabled' = true
)
Trino
SHOW TABLES;
Wenn Sie die Lese-/Schreibinteroperabilität und Tabellenverwaltung (Vorschau) aktivieren möchten, fügen Sie der WITH-Klausel die folgenden Attribute hinzu:
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: Projekt-ID in Google Cloud .CATALOG_ID: Die ID Ihres Katalogs.NAMESPACE_NAME: Der Name Ihres Katalognamespace.
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 Tabellenkennungen 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: Projekt-ID in Google Cloud .CATALOG_ID: Die ID Ihres Katalogs.NAMESPACE_NAME: Der Name Ihres Katalognamespace.