Mit dem Lakehouse-Laufzeitkatalog können Sie die Attribute vorhandener Katalogendpunkte in Borderless Lakehouse ändern.
Für Apache Iceberg REST-Katalogendpunkte können Sie den Anmeldedatenmodus, den Standard-Warehouse-Speicherort und den Katalogtyp aktualisieren. Sie können beispielsweise einen Katalog mit einem einzelnen Bucket auf einen Katalog mit mehreren Buckets (empfohlen) upgraden, damit Ihr Katalog mehrere Storage-Buckets umfassen kann.
Hinweis
- Weitere Informationen zur Funktionsweise des Lakehouse-Laufzeitkatalogs und zu den Einschränkungen des Dienstes finden Sie unter Informationen zum Lakehouse-Laufzeitkatalog.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
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.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aktualisieren eines Katalogs benötigen:
-
Alle:
- BigLake-Administrator (
roles/biglake.admin) für Ihr Projekt - Storage-Administrator (
roles/storage.admin) für Ihr Projekt
- BigLake-Administrator (
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.
Katalog aktualisieren
Sie können einen Katalog mit der Google Cloud Console, gcloud oder der REST API aktualisieren.
Informationen zum Aktualisieren eines föderierten Katalogs für den cloudübergreifenden Datenzugriff finden Sie im Einrichtungsleitfaden für Ihre Datenquelle. Weitere Informationen finden Sie unter AWS Glue Data Catalog.
Console
Rufen Sie in der Google Cloud Console die Seite Lakehouse auf.
Klicken Sie auf den Namen Ihres Katalogs.
Führen Sie auf der Seite Katalogdetails je nachdem, was Sie aktualisieren möchten, einen der folgenden Schritte aus:
- Katalogauthentifizierung bearbeiten: Klicken Sie im Abschnitt Authentifizierungsmethode auf Katalogauthentifizierung bearbeiten. Wählen Sie im Dialogfeld Anmeldedaten des Endnutzers oder Modus für die Bereitstellung von Anmeldedaten aus und klicken Sie dann auf Speichern.
- Bucket-Berechtigungen festlegen oder aktualisieren: Wenn Ihr Katalog den Modus „Credential Vending“ verwendet, rufen Sie den Abschnitt Authentifizierungsmethode auf. Klicken Sie bei einem Katalog mit mehreren Buckets auf Berechtigungen für Buckets festlegen. Klicken Sie bei einem Katalog mit einem einzelnen Bucket auf Bucket-Berechtigungen festlegen. Klicken Sie im Dialogfeld zur Bestätigung auf Bestätigen.
- In einen Katalog mit mehreren Buckets konvertieren oder Buckets hinzufügen: Wenn Sie einen Katalog mit einem einzelnen Bucket upgraden oder zusätzliche Storage-Buckets verknüpfen möchten, verwenden Sie den Befehl
gcloud biglake iceberg catalogs updateauf dem Tab gcloud oder die REST API auf dem Tab REST.
gcloud
Option 1: Katalogeigenschaften aktualisieren
Führen Sie den Befehl gcloud biglake iceberg catalogs update aus, um Katalogattribute wie Beschreibung oder eingeschränkte Standorte zu aktualisieren:
gcloud biglake iceberg catalogs update CATALOG_ID \ --project="PROJECT_ID" \ [--description="DESCRIPTION"] \ [--credential-mode="CREDENTIAL_MODE"] \ [--restricted-locations="RESTRICTED_LOCATIONS"]
Ersetzen Sie Folgendes:
CATALOG_ID: die ID Ihres Lakehouse-Laufzeitkatalogs.PROJECT_ID: Projekt-ID in Google Cloud .DESCRIPTION: (Optional) Eine Beschreibung für den Katalog.CREDENTIAL_MODE: (Optional) Die Authentifizierungsmethode. Verwenden Sieend-userfür Anmeldedaten von Endnutzern odervended-credentialsfür den Modus für die Bereitstellung von Anmeldedaten.RESTRICTED_LOCATIONS: (Optional) Eine durch Kommas getrennte Liste zusätzlicher zulässiger Storage-Buckets oder -Pfade. Achtung: Wenn Sie mehrere sich überschneidende Pfade oder Buckets angeben, kann diese Konfiguration zu Metadatenkonflikten, versehentlichem Überschreiben von Daten oder Sicherheitsproblemen wie der Weitergabe von Berechtigungen führen.
Option 2: Katalog mit einem Bucket auf einen Katalog mit mehreren Buckets upgraden (empfohlen)
Wenn Sie einen vorhandenen Katalog mit einem einzelnen Bucket auf einen Katalog mit mehreren Buckets upgraden möchten (empfohlen), führen Sie den Befehl gcloud biglake iceberg catalogs update aus und setzen Sie den Parameter --catalog-type auf biglake:
gcloud biglake iceberg catalogs update CATALOG_ID \ --project="PROJECT_ID" \ --catalog-type="biglake"
REST
Option 1: Katalogeigenschaften aktualisieren
Wenn Sie die Attribute eines Katalogs (z. B. die Beschreibung) mit der REST API ändern möchten, senden Sie eine PATCH-Anfrage an den Endpunkt UpdateIcebergCatalog mit dem entsprechenden updateMask:
PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=description
Der Anfragetext muss eine IcebergCatalog-JSON-Nutzlast mit den zu aktualisierenden Feldern enthalten:
{
"description": "Updated catalog description"
}
Option 2: Katalog mit einem Bucket auf einen Katalog mit mehreren Buckets upgraden (empfohlen)
Wenn Sie den Typ mit der REST API aktualisieren möchten, senden Sie eine PATCH-Anfrage an den Endpunkt UpdateIcebergCatalog mit dem catalogType im updateMask:
PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=catalog_type
Der Anfragetext muss eine JSON-Nutzlast vom Typ IcebergCatalog mit dem neuen Katalogtyp enthalten:
{
"catalog_type": "CATALOG_TYPE_BIGLAKE"
}
Ersetzen Sie Folgendes:
PROJECT_ID: Projekt-ID in Google Cloud .CATALOG_ID: die ID Ihres Lakehouse-Laufzeitkatalogs.
Hinweis: Nach dem Upgrade auf einen Katalog mit mehreren Buckets müssen Sie die Konfigurationen Ihrer Client-Abfrage-Engine (z. B. Spark oder Trino) aktualisieren, um den Warehouse-Pfad im Format bl:// anzugeben: bl://projects/PROJECT_ID/catalogs/CATALOG_ID.