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.

    Erforderliche Rollen zum Aktivieren von APIs

    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 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:

  • Tabellendetails ansehen: 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 Tabellenschema, die Partitionsspezifikation und die Metadateneigenschaften der Tabelle ansehen.

Spark 

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

Fügen Sie die Eigenschaften der TBLPROPERTIES Klausel 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 WITH Klausel 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 Katalognamespaces.

BigQuery

Wenn Sie Tabellendetails und Metadateneigenschaften für eine Apache Iceberg-Tabelle im Lakehouse-Laufzeitkatalog in BigQuery ansehen möchten, können Sie die Tabellendetails in der BigQuery-Konsole prüfen oder den Befehl bq show verwenden.

REST

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

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 LoadIcebergTableCredentials Endpunkt:

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 Katalognamespaces.
  • TABLE_NAME: der Name Ihrer Iceberg-Tabelle.

Nächste Schritte