Ansichtsdetails abrufen

Sie können das Schema, die Spaltenkommentare, die Attribute und die SQL-Definition einer Apache Iceberg-Ansicht, die im Lakehouse-Laufzeitkatalog registriert ist, mit Spark oder dem Apache Iceberg REST-Katalogendpunkt prüfen.

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 Inhaberrolle (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.
  4. Lesen Sie die Einschränkungen von Iceberg-Ansichten.
  5. Ansicht erstellen

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt und Ihren Storage-Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Abrufen von Ansichtsdetails benötigen:

  • Ansichtsdetails abrufen: BigLake-Betrachter (roles/biglake.viewer) – Ihr Projekt
  • Metadatendateien von Ansichten im Modus für Endnutzer-Anmeldedaten lesen: Storage-Objekt-Betrachter (roles/storage.objectViewer) – der Cloud Storage-Bucket

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Abrufen von Ansichtsdetails erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Ansichtsdetails abzurufen:

  • Details zur Ansicht abrufen: biglake.views.get für die Ansicht
  • Lesen Sie Metadatendateien im Modus für Endnutzer-Anmeldedaten: storage.objects.get im Cloud Storage-Bucket

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Eine vollständige Liste der Leseberechtigungen finden Sie unter Erforderliche Rollen und Berechtigungen.

Ansichtsdetails abrufen

Ansicht prüfen

Spark

Schema, Spaltenkommentare und Attribute der Ansicht anzeigen:

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

SQL-Anweisung anzeigen, die die Ansicht definiert:

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

Nur die Ansichtsattribute anzeigen:

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

Ersetzen Sie Folgendes:

  • NAMESPACE_NAME: der Name Ihres Namespace.
  • VIEW_NAME: der Name der Ansicht.

REST

Wenn Sie die aktuellen Metadaten einer Ansicht mit der REST API laden möchten, senden Sie eine GET-Anfrage an den Endpunkt GetIcebergView:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

Die Antwort enthält die metadata-location und die metadata der Ansicht.

Wenn Sie prüfen möchten, ob eine Ansicht vorhanden ist, ohne die zugehörigen Metadaten zu laden, senden Sie eine HEAD-Anfrage an denselben Pfad. Der Endpunkt CheckIcebergViewExists gibt 204 No Content zurück, wenn die Ansicht vorhanden ist, oder 404 Not Found, wenn sie nicht vorhanden ist.

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID in Google Cloud.
  • CATALOG_ID: die ID Ihres Katalogs.
  • NAMESPACE_NAME: der Name Ihres Katalog-Namespace.
  • VIEW_NAME: der Name der Ansicht.

Nächste Schritte