Katalogdetails abrufen

Mit dem Lakehouse-Laufzeitkatalog können Sie die Konfiguration und Metadaten von Katalogendpunkten im grenzenlosen Lakehouse prüfen.

Für Apache Iceberg-REST-Katalogendpunkte können Sie den REST-Katalog-URI, der für Clientverbindungen erforderlich ist, die Authentifizierungsmethode und das zugehörige Dienstkonto abrufen.

Hinweis

1. Lesen Sie Informationen zum Lakehouse-Laufzeitkatalog, um zu erfahren, wie der Lakehouse-Laufzeitkatalog funktioniert und welche Einschränkungen für den Dienst gelten.
Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigLake API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigLake API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

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

• Alle:
  • BigLake-Administrator (roles/biglake.admin)
  • Storage-Administrator (roles/storage.admin)

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.

Katalogdetails abrufen

Katalogkonfiguration und ‑attribute prüfen

Console

1. Öffnen Sie in der Google Cloud Console die Seite Lakehouse.

   Lakehouse aufrufen

2. Klicken Sie auf den Namen eines beliebigen Katalogs.

3. Auf der Seite Katalogdetails finden Sie Informationen zum Katalog, z. B. die Katalog-ID, den Erstellungszeitstempel, die REST-Katalog-URI, die Authentifizierungsmethode und das Dienstkonto.

gcloud

Führen Sie den gcloud biglake iceberg catalogs describe-Befehl aus, um einen Katalog mit gcloud zu beschreiben.

gcloud biglake iceberg catalogs describe CATALOG_ID \
    --project="PROJECT_ID"

Ersetzen Sie Folgendes:

• CATALOG_ID: die ID Ihres Katalogs.
• PROJECT_ID: Projekt-ID in Google Cloud .

REST

Wenn Sie Katalogdetails und die Konfiguration über die REST API abrufen möchten, senden Sie eine GET-Anfrage an den Endpunkt GetIcebergCatalog:

GET /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID

Die Antwort enthält ein IcebergCatalog-JSON-Objekt, das die Katalogkonfiguration beschreibt.

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID in Google Cloud .
• CATALOG_ID: die ID Ihres Katalogs.