Bereitstellung von Anmeldedaten aktivieren

Mit dem Lakehouse-Laufzeitkatalog können Sie den Modus für die Ausgabe von Anmeldedaten für Katalogendpunkte in Borderless Lakehouse aktivieren, um kurzlebige, eingeschränkte Speichertokens an autorisierte Abfrage-Engines und Arbeitslasten auszugeben. Bei dieser Authentifizierungsmethode müssen Sie oder Abfragelaufzeiten keine direkten Lese- und Schreibberechtigungen für die zugrunde liegenden Cloud Storage-Buckets haben.

Hinweis

  1. Weitere Informationen zur Funktionsweise des Lakehouse-Laufzeitkatalogs und zu den Einschränkungen des Dienstes finden Sie unter Informationen zum Lakehouse-Laufzeitkatalog.
  2. 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.

    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 zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aktivieren der Bereitstellung von Anmeldedaten benötigen:

  • Alle:
  • Automatisch bereitgestelltes Dienstkonto für den Apache Iceberg REST-Katalog: Storage Object User (roles/storage.objectUser) für alle zugehörigen Cloud Storage-Buckets. Nachdem Sie die Bereitstellung von Anmeldedaten aktiviert haben, weisen Sie dem automatisch bereitgestellten Apache Iceberg REST-Katalogdienstkonto Ihres Katalogs explizit die Rolle „Storage Object User“ (roles/storage.objectUser) für alle zugehörigen Storage-Buckets zu.

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.

Wenn die mit Ihrem Katalogendpunkt verknüpften Cloud Storage-Buckets durch einen VPC Service Controls-Dienstperimeter geschützt sind, müssen Sie auch eine Regel für eingehenden Traffic für das Katalogdienstkonto konfigurieren. Weitere Informationen finden Sie unter VPC Service Controls mit der Bereitstellung von Anmeldedaten verwenden.

Bereitstellung von Anmeldedaten aktivieren

Wenn die Authentifizierungsmethode für Ihren Apache Iceberg REST-Katalogendpunkt auf Endnutzeranmeldedaten festgelegt ist, können Sie sie auf den Modus für die Bereitstellung von Anmeldedaten umstellen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Lakehouse auf.

    Zu Lakehouse

  2. Klicken Sie in der Spalte Katalogname auf den Namen des Katalogs, den Sie aktualisieren möchten.

  3. Klicken Sie auf der Seite Katalogdetails im Abschnitt Authentifizierungsmethode auf  Katalogauthentifizierung bearbeiten.

  4. Wählen Sie im Authentifizierungsdialogfeld Modus für Bereitstellung von Anmeldedaten aus.

    Das automatisch bereitgestellte Dienstkonto des Katalogs benötigt die Rolle „Storage Object User“ (roles/storage.objectUser) für alle zugehörigen Cloud Storage-Buckets. Standardmäßig hat es keinen Zugriff. Ohne diese Rolle haben die bereitgestellten Anmeldedaten nicht genügend Berechtigungen, um Speicherschreibvorgänge auszuführen.

  5. Klicken Sie auf Speichern.

  6. Klicken Sie im Abschnitt Authentifizierungsmethode auf Berechtigungen für Buckets festlegen, um die Bucket-Berechtigungen für einen Katalog mit mehreren Buckets zu gewähren, oder auf Bucket-Berechtigungen festlegen, um die Bucket-Berechtigungen für einen Katalog mit einem einzelnen Bucket zu gewähren.

  7. Klicken Sie im Dialogfeld zur Bestätigung auf Bestätigen.

Dadurch wird dem Dienstkonto Ihres Katalogs die Rolle „Storage Object User“ für alle zugehörigen Cloud Storage-Buckets gewährt, sofern sie noch nicht gewährt wurde.

gcloud

Führen Sie den Befehl gcloud biglake iceberg catalogs update aus.

gcloud biglake iceberg catalogs update \
    CATALOG_NAME \
    --project PROJECT_ID \
    --credential-mode vended-credentials

Ersetzen Sie Folgendes:

  • CATALOG_NAME: ein Name für Ihren Katalog. Bei Lakehouse-Katalogen ist dies der Name Ihres benutzerdefinierten Katalogs. Bei Cloud Storage-Bucket-Katalogen entspricht dies der Cloud Storage-Bucket-ID, die mit dem REST-Katalog verwendet wird. Dieser Name wird auch als Katalog-ID verwendet, wenn Sie diese Tabellen über BigQuery abfragen.
  • PROJECT_ID: Ihre Projekt-ID in Google Cloud.

    Nachdem Sie die Bereitstellung von Anmeldedaten aktiviert haben, weisen Sie dem automatisch bereitgestellten Apache Iceberg REST-Katalogdienstkonto Ihres Katalogs explizit die Rolle Storage Object User (roles/storage.objectUser) für alle zugehörigen Storage-Buckets zu.

REST

Wenn Sie den Modus für die Bereitstellung von Anmeldedaten mit der REST API aktivieren möchten, senden Sie eine PATCH-Anfrage an den Endpunkt UpdateIcebergCatalog:

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=credential_mode

Der Anfragetext muss eine JSON-Nutzlast vom Typ IcebergCatalog enthalten, wobei credential_mode auf VENDED_CREDENTIALS festgelegt ist.

Ersetzen Sie Folgendes:

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