Tabellendetails abrufen

Wenn Sie Tabellendetails ansehen, werden das zugrunde liegende Schema, die Tabelleneigenschaften und die Konfigurationsmetadaten für eine Apache Iceberg-Tabelle im Lakehouse-Laufzeitkatalog angezeigt.

Im Modus für die Bereitstellung von Anmeldedaten rufen Abfrage-Engines auch kurzlebige Zugriffsanmeldedaten ab, um sicher mit den zugrunde liegenden Cloud Storage-Dateien zu interagieren, ohne dass direkte IAM-Speicherberechtigungen erforderlich sind.

Sie können Tabellendetails über die Google Cloud Console, SQL-Befehle vom Typ „describe“ in Spark und Trino oder die Open-Source-Iceberg-REST-Katalog-API-Spezifikation prüfen.

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.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, damit Sie die Berechtigungen erhalten, die zum Ansehen von Tabellendetails 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.

Tabellendetails abrufen

Tabellenschema und -eigenschaften prüfen.

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. Klicken Sie in der Tabelle Namespace-Details auf den Namen der Tabelle, die Sie prüfen möchten.

  4. Auf der Seite Tabellendetails können Sie das Schema, die Partitionsspezifikation und die Metadateneigenschaften der Tabelle ansehen.

Spark 

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").show()

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

REST

Wenn Sie Tabellenmetadaten mit der REST API abrufen möchten, senden Sie eine GET-Anfrage an den Endpunkt GetIcebergTable:

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

Wenn Sie im Modus für die Bereitstellung von Anmeldedaten kurzlebige Tabellenanmeldedaten laden möchten, senden Sie eine GET-Anfrage an den Endpunkt LoadIcebergTableCredentials:

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

Ersetzen Sie Folgendes:

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

Nächste Schritte