Aggiungi Replicat per lo storage degli oggetti Oracle

Impara ad aggiungere e configurare un processo Replicat per una destinazione di storage degli oggetti Oracle.

Prima di iniziare

Prima di aggiungere Replicat, assicurarsi di disporre dei seguenti elementi:

• Considerazioni sulla configurazione e best practice per lo storage degli oggetti Oracle esaminate

• OCID compartimento

  Suggerimento: è possibile trovare l'OCID del compartimento nella pagina dei dettagli del compartimento.

  1. Aprire il menu di navigazione della console di Oracle Cloud, selezionare Identità, quindi Compartimenti.

  2. Selezionare il compartimento dalla lista per accedere alla pagina dei dettagli del compartimento.

  3. Copiare l'OCID compartimento dalla sezione Informazioni compartimento.

  Per ulteriori informazioni, vedere Trova l'OCID di un compartimento.

• Nome bucket di Oracle Object Storage

  Suggerimento: Oracle consiglia di creare un bucket di storage degli oggetti Oracle personale.

  1. Aprire il menu di navigazione della console di Oracle Cloud, selezionare Memorizzazione, quindi Bucket.

  2. Selezionare Crea bucket.

  3. Nel pannello Crea bucket immettere un nome, quindi selezionare Crea.

  Per ulteriori informazioni, vedere Uso della console per creare un bucket.

Aggiungi un Replicat (26ai)

Assicurarsi di rivedere i prerequisiti specifici di questo tipo di destinazione.

1. Nel menu di navigazione della console di distribuzione OCI GoldenGate, selezionare Replicat.

2. Nella pagina Replicat selezionare Aggiungi Replicat.

3. Nel pannello Aggiungi replica, nella pagina Informazioni replica, completare i campi in base alle esigenze, quindi selezionare Successivo:

   • Selezionare un tipo di replica:

     • Replicat classico

     • Replicat coordinato

   • Immettere un valore nel campo Nome processo con una lunghezza massima di 5 caratteri.

   • Immettere una Descrizione per distinguere questo processo dagli altri.

4. Nella pagina Opzioni replica, completare i campi in base alle esigenze, quindi selezionare Successivo:

   • Trail Replicat:

     • Immettere un Nome.

     • Immettere una sottodirectory se si prevede che il file trail si trovi in una posizione diversa da quella predefinita.

     • Selezionare un profilo di cifratura. Se non è stato creato un profilo di cifratura, il wallet locale viene selezionato per impostazione predefinita.

     • Per Inizio, selezionare il punto di partenza per l'elaborazione dei dati:

       • Posizione nel log (predefinito)

       • Now

       • Orario personalizzato

   • Posizione trail:

     • Immettere il numero sequenza.

     • Immettere l'offset RBA.

     • Selezionare la destinazione dall'elenco a discesa.

       Nota: a seconda della selezione della destinazione, è possibile che siano disponibili opzioni aggiuntive, ad esempio le ubicazioni di streaming, area intermedia e unione e area intermedia.

   • Credenziali destinazione:

     • Selezionare un dominio.

     • Selezionare un'alias all'interno del dominio specificato.

     • Selezionare una tabella di checkpoint. Lasciare la selezione predefinita o selezionare la tabella Checkpoint creata per la distribuzione di destinazione.

     • Selezionare il numero massimo di thread (solo Replicat coordinate).

5. Nella pagina Opzioni gestite completare i campi facoltativi in base alle esigenze, quindi selezionare Successivo.

   • Selezionare un nome profilo, se disponibile.

   • Abilita stato critico per la distribuzione.

   • Abilitare e configurare le impostazioni di avvio automatico.

6. Nella pagina File parametri è possibile aggiungere parametri per configurare ulteriormente Replicat. Ad esempio:

   table source.table1;

   Nota:

   Per impostazione predefinita, GoldenGate utilizza l'ora di Greenwich (GMT). Utilizzare SETENV per sostituire l'impostazione predefinita per Replicat. Questa modifica non si applica alle distribuzioni. Ad esempio:

   setenv (TZ="US/Eastern")
   setenv (TZ="GMT+5")

7. Nella pagina Proprietà file configurare le proprietà Handler file e Gestore eventi OCI in base alle esigenze, quindi selezionare Successivo. Di seguito sono riportate alcune delle proprietà da considerare per la modifica.

   1. gg.handler.name.format: selezionare la modalità di formattazione dei dati di output. Le opzioni disponibili includono:

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      Per il parquet, è necessario applicare proprietà aggiuntive. Per i dettagli, vedere Parquet per Oracle Object Storage.

   2. gg.handler.name.fileNameMappingTemplate: genera i nomi dei file in modo dinamico utilizzando Parole chiave modello.

   3. gg.handler.name.inactivityRollInterval: GoldenGate crea un file e lo mantiene aperto per la scrittura. Questa proprietà chiude il file dopo il periodo di inattività designato (nessuna transazione in entrata) e quindi caricato nello storage degli oggetti Oracle.

   4. gg.eventhandler.name.compartmentID: immettere l'OCID del compartimento.

   5. gg.eventhandler.name.bucketMappingTemplate: immettere il nome del bucket di storage degli oggetti.

   Ulteriori informazioni sulle proprietà File Writer Handler e OCI Event Handler configuration.

   Nota: è anche possibile aggiungere formatter collegabili in base alle esigenze. Per ulteriori informazioni, vedere Formatter collegabili.

8. Selezionare Crea ed esegui. Se si seleziona Crea, è possibile avviare manualmente Replicat in un secondo momento dalla pagina Replicat.

Aggiungi un Replicat (21c)

1. Nella console di distribuzione GoldenGate OCI, nella pagina Panoramica del servizio di amministrazione, selezionare Aggiungi Replicat (icona più).

2. Nella pagina Aggiungi Replicat selezionare un tipo di Replicat, quindi selezionare Successivo.

   I tipi di Replicat sono:

   • Replicat classico

   • Replicat coordinato

3. Nella pagina Opzioni replica, completare i campi riportati di seguito, quindi selezionare Successivo.

   1. Per Nome processo, immettere un nome per il processo Replicat.

   2. (Facoltativo) Per Descrizione, immettere una breve descrizione per distinguere questo processo dagli altri.

   3. Per Nome trail, immettere il nome del trail di due caratteri.

   4. Per Destinazione, selezionare Storage oggetti Oracle dall'elenco a discesa.

   5. Per gli alias disponibili per OCI, selezionare l'alias dall'elenco a discesa.

4. Nella pagina File dei parametri aggiungere e configurare i parametri Replicat in base alle esigenze, quindi selezionare Successivo.

   table source.table1;

   Nota:

   Per impostazione predefinita, GoldenGate utilizza l'ora di Greenwich (GMT). Utilizzare SETENV per sostituire l'impostazione predefinita per l'estrazione. Questa modifica si applica solo al processo di estrazione e non alla distribuzione.

   setenv (TZ="US/Eastern")
   setenv (TZ="GMT+5")

5. Nella pagina Proprietà file configurare le proprietà Handler file e Gestore eventi OCI in base alle esigenze, quindi selezionare Successivo. Di seguito sono riportate alcune delle proprietà da considerare per la modifica.

   1. gg.handler.name.format: selezionare la modalità di formattazione dei dati di output. Le opzioni disponibili includono:

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      Per il parquet, è necessario applicare proprietà aggiuntive. Per i dettagli, vedere Parquet per Oracle Object Storage.

   2. gg.handler.name.fileNameMappingTemplate: genera i nomi dei file in modo dinamico utilizzando Parole chiave modello.

   3. gg.handler.name.inactivityRollInterval: GoldenGate crea un file e lo mantiene aperto per la scrittura. Questa proprietà chiude il file dopo il periodo di inattività designato (nessuna transazione in entrata) e quindi caricato nello storage degli oggetti Oracle.

   4. gg.eventhandler.name.compartmentID: immettere l'OCID del compartimento.

   5. gg.eventhandler.name.bucketMappingTemplate: immettere il nome del bucket di storage degli oggetti.

   Ulteriori informazioni sulle proprietà File Writer Handler e OCI Event Handler.

   Nota: è anche possibile aggiungere formatter collegabili in base alle esigenze. Per ulteriori informazioni, vedere Uso dei formatter collegabili.

6. Selezionare Aggiungi ed esegui.

Si torna alla pagina Panoramica del servizio di amministrazione, in cui è possibile monitorare lo stato del processo Replicat. Selezionare il nome del processo per visualizzarne i dettagli e accedere ai report.

Contenuto correlato

• Dettagli destinazione storage degli oggetti Oracle

Problemi noti con le connessioni allo storage degli oggetti Oracle

Errore di replica dello storage degli oggetti Oracle quando si utilizza il principal risorsa

Se la connessione allo storage degli oggetti Oracle utilizza l'autenticazione principal risorsa, Replicat non riesce con il seguente errore:

ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

Soluzione: per risolvere questo problema, modificare la connessione, quindi selezionare un metodo di autenticazione diverso.

Mancata corrispondenza OCID utente nella connessione allo storage degli oggetti Oracle (solo utenti federati)

Se un utente federato seleziona Utilizza l'utente corrente durante la creazione di una connessione allo storage degli oggetti Oracle, il relativo OCID non corrisponde all'OCID selezionato dal sistema.

Soluzione: quando si crea una connessione allo storage degli oggetti Oracle, assicurarsi di scegliere Specificare un altro utente, quindi immettere l'OCID dell'utente federato.

Per trovare l'OCID utente, selezionare Profilo nell'intestazione globale della console di Oracle Cloud, quindi selezionare il nome utente. Nella pagina Dettagli utente, in Informazioni utente, selezionare Mostra per OCID.