Verbindung zu Apache Iceberg herstellen

Hier erfahren Sie, wie Sie eine Verbindung zu Apache Iceberg in OCI GoldenGate erstellen.

Bevor Sie beginnen

Bevor Sie die Verbindung erstellen, stellen Sie sicher, dass Sie:

Verbindung erstellen

So erstellen Sie eine Verbindung zu Apache Iceberg:
  1. Klicken Sie in der OCI GoldenGate-Seite "Überblick" auf Verbindungen.
    Sie können auch im Abschnitt "Ersten Schritte" auf Verbindung erstellen klicken und damit mit Schritt 3 fortfahren.
  2. Klicken Sie auf der Seite "Verbindungen" auf Verbindung erstellen.
  3. Füllen Sie auf der Seite "Verbindung erstellen" die Felder folgendermaßen aus:
    1. Geben Sie unter Name einen Namen für die Verbindung an.
    2. (Optional) Unter Beschreibung geben Sie eine Beschreibung ein, mit der Sie diese Verbindung von anderen unterscheiden können.
    3. (Nur für GoldenGate auf Multicloud) Wählen Sie Ihr Abonnement aus, und füllen Sie die folgenden Felder aus.
      1. Wählen Sie aus der Dropdown-Liste Compartment das Compartment aus, in dem der Ressourcenanker gespeichert ist.
      2. Wählen Sie die Multicloud-Partnerregion aus.
      3. Wählen Sie Ihre Partnerverfügbarkeitszone aus. Die verfügbaren Optionen werden basierend auf der ausgewählten Multicloud-Partnerregion aufgefüllt.
    4. Wählen Sie unter Compartment das Compartment aus, in dem die Verbindung erstellt werden soll.
    5. Wählen Sie unter Typ unter Big Data die Option Apache Iceberg aus.
    6. Wählen Sie einen Katalogtyp aus der Dropdown-Liste aus, und füllen Sie die relevanten Katalogfelder aus:
      1. Geben Sie unter Glue die Glue-ID ein.
      2. Für Hadoop sind keine zusätzlichen Informationen erforderlich.
      3. Geben Sie unter Nessie Folgendes an:
        • URI: Geben Sie die Nessie-Katalog-URI ein.
        • Verzweigung: Geben Sie den aktiven Verzweigungsnamen ein, aus dem Nessie Tabellenmetadaten liest und schreibt.
      4. Geben Sie unter Polaris Folgendes an:
        • URI: Geben Sie die Polaris-Katalog-URI ein.
        • Name: Geben Sie den Namen ein, unter dem Polaris Iceberg-Tabellen registriert.
        • Client-ID: Geben Sie die OAuth-Client-ID für die Authentifizierung ein.
        • Client Secret: Wählen Sie das Client Secret aus, oder klicken Sie auf Client Secret erstellen, um ein neues Secret zu erstellen. Wenn Sie ein neues Client Secret erstellen möchten, geben Sie die folgenden Informationen an:
          • Name
          • (Optional) Beschreibung
          • Wählen Sie das Compartment aus, in dem das Eigenschafts-Secret gespeichert ist.
          • Wählen Sie den Vault aus, in dem das Eigenschaften-Secret gespeichert werden soll.
          • Wählen Sie den zu verwendenden Verschlüsselungsschlüssel aus.
          • Geben Sie das Benutzerkennwort ein, und bestätigen Sie das Benutzerkennwort.
        • Hauptrolle: Geben Sie die Snowflake-Rolle ein, die für den Zugriff auf Polaris verwendet wird.
      5. Geben Sie unter Rest Folgendes an:
        • URI: Geben Sie die Basis-URL für die REST-Katalog-API ein.
        • Eigenschaften-Secret: Wählen Sie das Eigenschaften-Secret aus, oder klicken Sie auf Eigenschaften-Secret erstellen, um ein neues zu erstellen. Wenn Sie ein neues Eigenschafts-Secret erstellen möchten, geben Sie die folgenden Informationen an:
          • Name
          • (Optional) Beschreibung
          • Wählen Sie das Compartment aus, in dem das Eigenschafts-Secret gespeichert ist.
          • Wählen Sie den Vault aus, in dem das Eigenschaften-Secret gespeichert werden soll.
          • Wählen Sie den zu verwendenden Verschlüsselungsschlüssel aus.
          • Laden Sie die Properties Secret-ID hoch.
    7. Wählen Sie in der Dropdown-Liste einen Speichertyp aus, und füllen Sie die relevanten Speicherfelder aus:
  4. Erweitern Sie Erweiterte Optionen anzeigen. Sie können folgende Optionen konfigurieren:
    • Sicherheit
      • Deaktivieren Sie die Option Vault Secrets verwenden, wenn Sie keine Kennwort-Secrets für diese Verbindung verwenden möchten. Wenn diese Option nicht ausgewählt ist, gilt Folgendes:
        • Wählen Sie Von Oracle verwalteten Verschlüsselungsschlüssel verwenden aus, um die gesamte Verschlüsselungsschlüsselverwaltung an Oracle zu übergeben.
        • Wählen Sie Verschlüsselungsschlüssel von Kunden verwalten aus, um einen bestimmten Verschlüsselungsschlüssel auszuwählen, der in Ihrem OCI Vault gespeichert ist, um Ihre Verbindungszugangsdaten zu verschlüsseln.
    • Netzwerkverbindungen
      • Gemeinsamer Endpunkt, um einen Endpunkt für das zugewiesene Deployment freizugeben. Sie müssen die Konnektivität von der Ingress-IP des Deployments zulassen.
      • Dedizierter Endpunkt für Netzwerktraffic über einen dedizierten Endpunkt im zugewiesenen Subnetz in Ihrem VCN. Sie müssen Konnektivität von den Ingress-IPs dieser Verbindung zulassen.

        Hinweis:

        • Wenn die Zuweisung einer dedizierten Verbindung sieben Tage lang aufgehoben bleibt, konvertiert der Service sie in eine gemeinsame Verbindung.
        • Weitere Informationen zur Oracle GoldenGate-Konnektivität.
    • Sicherheitsattribute: Fügen Sie Sicherheitsattribute hinzu, um den Zugriff auf diese Verbindung mit Zero Trust Packet Routing (ZPR) zu kontrollieren.
    • Tags: Sie können Tags hinzufügen, um Ihre Ressourcen zu organisieren.
  5. Klicken Sie auf Create.
Nachdem die Verbindung erstellt wurde, wird sie in der Liste "Verbindung" angezeigt. Stellen Sie sicher, dass Sie die Verbindung einem Deployment zuweisen, um sie in einem Datenreplikationsprozess zu verwenden.

Bekannte Probleme

Problem mit Apache Iceberg-Verbindungen in OCI GoldenGate

Wenn bei der Verwendung von Apache Iceberg-Verbindungen der folgende Fehler auftritt, öffnen Sie ein Supportticket, geben Sie die Details und die Fehlermeldung weiter:

ERROR 2025-07-08 13:34:09.000481 [main] -  Parameter [awsSecretKey] is missing in the
      connection payload. Parameter [awsSecretKey] is missing in the connection payload.