Connessione ad Apache Iceberg

Scopri come creare una connessione a Apache Iceberg in OCI GoldenGate.

Prima di iniziare

Assicurarsi di effettuare quanto riportato di seguito.

Rivedere il modo in cui OCI GoldenGate si connette all'origine e alle destinazioni.
Configurare i criteri necessari per abilitare l'accesso sicuro a vault e segreti, ad esempio l'uso di segreti, i vault e la lettura di bundle di segreti. Per ulteriori informazioni, vedere Criteri consigliati minimi.

Crea la connessione

Per creare la connessione a Apache Iceberg, effettuare le operazioni riportate di seguito:

Nella pagina Panoramica di OCI GoldenGate, selezionare Connessioni.

È inoltre possibile selezionare Crea connessione nella sezione Introduzione e passare al passo 3.
Nella pagina Connessioni selezionare Crea connessione.
Nella pagina Crea connessione, completare i campi come indicato di seguito.
1. In Nome, immettere un nome per la connessione.
2. (Facoltativo) In Descrizione, immettere una descrizione che consenta di distinguere questa connessione dalle altre.
3. (Solo per GoldenGate on Multicloud) Selezionare la propria sottoscrizione, quindi completare i campi riportati di seguito.
  1. Nell'elenco a discesa Compartimento selezionare il compartimento in cui risiede l'ancora risorsa.
  2. Selezionare l'area partner multicloud.
  3. Seleziona la tua zona di disponibilità dei partner. Le opzioni disponibili vengono popolate in base all'area partner multicloud selezionata.
4. In Compartimento selezionare il compartimento in cui creare la connessione.
5. In Tipo, in Big Data, selezionare Apache Iceberg.
6. Selezionare un tipo di catalogo dall'elenco a discesa, quindi completare i campi catalogo pertinenti:
  1. Per Glue, immettere l'ID collegamento.
  2. Per Hadoop non sono necessarie informazioni aggiuntive.
  3. Per Nessie, specificare:
    - URI: immettere l'URI del catalogo Nessie.
    - Diramazione: immettere il nome di diramazione attivo da cui Nessie legge e scrive i metadati della tabella.
  4. Per Polaris, specificare:
    - URI: immettere l'URI del catalogo Polaris.
    - Nome: immettere il nome in cui Polaris registra le tabelle Iceberg.
    - ID client: immettere l'ID client OAuth da utilizzare per l'autenticazione.
    - Segreto client: selezionare il segreto client oppure selezionare Crea segreto client per crearne uno nuovo. Se si sceglie di creare un nuovo segreto client, fornire le informazioni riportate di seguito.
      - Name
      - (Facoltativo) Descrizione
      - Selezionare il compartimento in cui risiede il segreto delle proprietà.
      - Selezionare il Vault in cui memorizzare il segreto delle proprietà.
      - Selezionare la chiave di cifratura da utilizzare.
      - Immettere la password utente, quindi confermare la password utente.
    - Ruolo principale: immettere il ruolo Fiocco di neve utilizzato per accedere a Polaris.
  5. Per Rest, specificare:
    - URI: immettere l'URL di base per l'API del catalogo REST.
    - Segreto proprietà: selezionare il segreto proprietà oppure selezionare Crea segreto proprietà per crearne uno nuovo. Se si sceglie di creare un nuovo segreto proprietà, fornire le informazioni riportate di seguito.
      - Name
      - (Facoltativo) Descrizione
      - Selezionare il compartimento in cui risiede il segreto delle proprietà.
      - Selezionare il Vault in cui memorizzare il segreto delle proprietà.
      - Selezionare la chiave di cifratura da utilizzare.
      - Caricare l'ID segreto proprietà.
7. Selezionare un tipo di memorizzazione dall'elenco a discesa, quindi completare i campi di memorizzazione pertinenti.
  - Amazon S3: consulta Connettiti ad Amazon S3
  - Storage di Google Cloud: vedere Connettersi a Google Cloud storage
  - Storage di Azure Data Lake: vedere Connettersi allo storage di Azure Data Lake
8. Espandere l'area Mostra opzioni avanzate È possibile configurare le opzioni riportate di seguito.
  - Sicurezza
    - Deselezionare Usa segreti vault per non utilizzare segreti password per questa connessione. Se l'opzione non viene selezionata:
      - Selezionare Usa chiave di cifratura gestita da Oracle per lasciare a Oracle tutta la gestione delle chiavi di cifratura.
      - Selezionare Usa chiave di cifratura gestita dal cliente per selezionare una chiave di cifratura specifica memorizzata nel vault OCI per cifrare le credenziali di connessione.
  - Connettività di rete
    - Endpoint condiviso per condividere un endpoint con la distribuzione assegnata. È necessario consentire la connettività dall'IP in entrata della distribuzione.
    - Endpoint dedicato, per il traffico di rete attraverso un endpoint dedicato nella subnet assegnata nella tua VCN. È necessario consentire la connettività dagli IP in entrata di questa connessione.
      Nota:
      
      Se un collegamento dedicato rimane non assegnato per sette giorni, il servizio lo converte in una connessione condivisa.
      
      Ulteriori informazioni sulla connettività di Oracle GoldenGate.
  - Attributi di sicurezza: aggiungere attributi di sicurezza per controllare l'accesso a questa connessione utilizzando Zero Trust Packet Routing (ZPR).
  - Tag: Aggiunge tag per organizzare le risorse.
Selezionare Crea.

Una volta creata, la connessione viene visualizzata nell'elenco Connessione. Assicurarsi di assegnare la connessione a una distribuzione per utilizzarla in un processo di replica dei dati.

Passi successivi

Problemi noti

Problema con le connessioni Apache Iceberg in OCI GoldenGate

Se si verifica il seguente errore durante l'utilizzo delle connessioni Apache Iceberg, aprire un ticket di supporto, condividere i dettagli e il messaggio di errore:

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.