Tabellendetails abrufen

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

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

Sie können Tabellendetails über die Google Cloud Console, SQL-DESCRIBE-Befehle in Spark und Trino oder die REST API aufrufen.

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 Aufrufen von Tabellendetails haben:

  • Tabellendetails ansehen: 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, 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.

Tabellendetails abrufen

Tabellenschema und ‑attribute 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 Sie noch keinen haben.

  3. Klicken Sie in der Tabelle Namespace details (Namespace-Details) auf den Namen der Tabelle, die Sie untersuchen möchten.

  4. Sehen Sie sich auf der Seite Tabellendetails das Schema, die Partitionsspezifikation und die Metadateneigenschaften der Tabelle an.

Spark 

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").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 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

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

Wenn Sie eine Tabelle mit gcloud beschreiben möchten, führen Sie den gcloud biglake iceberg tables describe-Befehl aus.

gcloud biglake iceberg tables describe 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 Tabellendetails und Metadateneigenschaften für eine Apache Iceberg-Tabelle im Lakehouse-Laufzeitkatalog aus BigQuery aufrufen möchten, können Sie die Tabellendetails in der BigQuery-Konsole ansehen oder den Befehl bq show verwenden.

REST

Wenn Sie Tabellen-Metadaten 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 kurzlebige Tabellenanmeldedaten im Modus für die Bereitstellung von Anmeldedaten 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: Projekt-ID in Google Cloud .
  • CATALOG_ID: die ID Ihres Lakehouse-Laufzeitkatalogs.
  • NAMESPACE_NAME: Der Name Ihres Katalognamespace.
  • TABLE_NAME: Der Name Ihrer Iceberg-Tabelle.

Nächste Schritte