Katalog aktualisieren

Wenn Sie einen Katalog aktualisieren (z. B. einen Apache Iceberg REST-Katalog), können Sie seine Eigenschaften ändern, z. B. den Modus für Anmeldedaten, den Standardspeicherort des Data Warehouse oder den zugrunde liegenden Katalogtyp. Sie können beispielsweise ein Upgrade eines Legacy-Cloud Storage-Bucket-Katalogs (gs://-Katalog) auf einen BigLake-Katalog (bl://-Katalog) durchführen.

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 IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Informationen zum Zuweisen von Rollen.

    API aktivieren

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die zum Aktualisieren eines Katalogs erforderlich sind:

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 die Konfiguration eines Katalogs aktualisieren, z. B. die Beschreibung, den Modus für Anmeldedaten oder die zulässigen Standorte ändern.

Außerdem können Sie ein Upgrade eines vorhandenen Cloud Storage-Bucket-Katalogs (Legacy-gs://-Katalog) auf einen BigLake-Katalog (bl://-Katalog) durchführen. Der aktualisierte Katalog behält den Namen des ursprünglichen Buckets bei. Nach dem Upgrade können Sie mehrere Buckets verknüpfen und eingeschränkte Standorte konfigurieren.

Sie können einen Katalog über die Google Cloud Console, gcloud, oder die REST API aktualisieren.

Console

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

    Zu Lakehouse

  2. Klicken Sie in der Zeile des Katalogs, den Sie aktualisieren möchten, auf Weitere Katalogaktionen > Bearbeiten.

  3. Ändern Sie unter Katalogkonfiguration die Einstellungen, die Sie aktualisieren möchten.

  4. Klicken Sie auf Speichern.

gcloud

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

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    [--description="DESCRIPTION"] \
    [--credential-mode="CREDENTIAL_MODE"] \
    [--restricted-locations="RESTRICTED_LOCATIONS"] \
    [--catalog-type=biglake]

Ersetzen Sie Folgendes:

  • CATALOG_ID: die ID Ihres Lakehouse-Laufzeitkatalogs.
  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • DESCRIPTION: (Optional) eine Beschreibung für den Katalog.
  • CREDENTIAL_MODE: (Optional) die Authentifizierungsmethode. Verwenden Sie end-user für Anmeldedaten des Endnutzers oder vended-credentials für den Modus für die Bereitstellung von Anmeldedaten.
  • RESTRICTED_LOCATIONS: (Optional) eine durch Kommas getrennte Liste mit zusätzlichen zulässigen Speicher-Buckets oder -Pfaden.

REST

Wenn Sie einen Katalog ändern oder seinen Typ über die REST API aktualisieren möchten, senden Sie eine PATCH Anfrage an den UpdateIcebergCatalog Endpunkt mit der entsprechenden updateMask:

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=icebergCatalog.catalogType,icebergCatalog.description

Der Anfragetext muss eine IcebergCatalog-JSON-Nutzlast mit den zu aktualisierenden Feldern enthalten:

{
  "catalogType": "BIGLAKE",
  "description": "Updated catalog description"
}

Ersetzen Sie Folgendes:

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