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 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, mit SQL DESCRIBE Befehlen in Spark und Trino oder über die REST API prüfen.

Hinweis

  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

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

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

Tabellenfunktionen und -support

Wenn Sie Tabellen im Lakehouse-Laufzeitkatalog verwenden, ist es hilfreich, die verschiedenen Tabellentypen und ihre optionalen Funktionen zu verstehen . 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 (allgemeine Verfügbarkeit) 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.

Tabellendetails abrufen

Prüfen Sie das Tabellenschema und die Tabelleneigenschaften.

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

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

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

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

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

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

gcloud

Führen Sie den Befehl gcloud biglake iceberg tables describe aus, um eine Tabelle mit gcloud zu beschreiben.

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: Ihre Google Cloud Projekt-ID.
  • 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 in BigQuery aufrufen möchten, können Sie die Tabellendetails in der BigQuery-Konsole prüfen oder den Befehl bq show verwenden.

REST

Senden Sie eine GET Anfrage an den GetIcebergTable Endpunkt, um Tabellenmetadaten mit der REST API abzurufen:

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

Senden Sie eine GET Anfrage an den LoadIcebergTableCredentials Endpunkt, um im Modus für die Bereitstellung von Anmeldedaten kurzlebige Tabellenanmeldedaten zu laden:

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