Per aggiungere un valore in Replicat in GoldenGate 26ai:
Nel menu di navigazione della console di distribuzione OCI GoldenGate fare clic su Replicat.
Nella pagina Replicat, fare clic su Aggiungi Replicat.
Nel pannello Aggiungi Replicat, nella pagina Informazioni su Replicat, completare i campi in base alle esigenze, quindi fare clic su Avanti:
Selezionare un tipo di replicat:
Replicat classico
Replicat coordinato
Immettere un nome processo con una lunghezza massima di 5 caratteri.
Immettere una Descrizione per facilitare la distinzione tra questo processo e gli altri.
Nella pagina Opzioni Replicat, completare i campi in base alle esigenze, quindi fare clic su Avanti:
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, per impostazione predefinita viene selezionato il wallet locale.
Per Inizia, selezionare il punto di partenza per l'elaborazione dei dati:
Posizione nel log (impostazione predefinita)
Now
Orario personalizzato
Posizione trail:
Immettere il numero di sequenza.
Immettere l'offset RBA.
Selezionare la destinazione dall'elenco a discesa.
Nota
A seconda della selezione della destinazione, è possibile disporre di opzioni aggiuntive, ad esempio le posizioni 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 Checkpoint. Lasciare la selezione predefinita o selezionare la tabella Checkpoint creata per la distribuzione di destinazione.
Selezionare il Numero massimo di thread (solo replicati coordinati).
Nella pagina Opzioni gestite, completare i campi facoltativi in base alle esigenze, quindi fare clic su Avanti:
Selezionare un nome profilo, se disponibile.
Abilitare Critico per lo stato di distribuzione.
Abilitare e configurare le impostazioni di avvio automatico.
Nella pagina File dei parametri è possibile aggiungere i parametri per configurare ulteriormente Replicat. Ad esempio:
table source.table1;
Se si utilizza Replicat coordinato, aggiungere TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties al file dei parametri.
Nota
Per impostazione predefinita, GoldenGate utilizza l'ora di Greenwich (GMT, Greenwich Mean Time). Utilizzare SETENV per sostituire l'impostazione predefinita per questo processo Replicat. Questa modifica non si applica alle distribuzioni. Ad esempio:
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
Nella pagina File proprietà, configurare le proprietà Handler di file e Handler di eventi OCI in base alle esigenze, quindi fare clic su Successivo. Di seguito sono riportate alcune delle proprietà da considerare per la modifica.
gg.handler.name.format: selezionare la modalità di formattazione dei dati di output. Le opzioni disponibili includono:
gg.handler.name.fileNameMappingTemplate: genera i nomi dei file in modo dinamico utilizzando Parole chiave modello.
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 in Storage degli oggetti Oracle.
gg.eventhandler.name.compartmentID: immettere l'OCID del compartimento.
gg.eventhandler.name.bucketMappingTemplate: immettere il nome del bucket di storage degli oggetti.
È inoltre possibile aggiungere formatter collegabili in base alle esigenze. Per ulteriori informazioni, vedere Formatter collegabili.
Fare clic su Crea ed esegui. Se si fa clic su Crea, è possibile avviare manualmente Replicat in un secondo momento dalla pagina Replicat.
Aggiungi un Replicat (21c)
Per aggiungere un Replicat per una destinazione di Oracle Object Storage, effettuare le operazioni riportate di seguito.
Nella console di distribuzione OCI GoldenGate, nella pagina Panoramica del servizio di amministrazione, fare clic su Aggiungi Replicat (icona più).
Nella pagina Aggiungi Replicat, selezionare un tipo di Replicat, quindi fare clic su Avanti.
Di seguito sono riportati i tipi di repliche.
Replicat classico
Replicat coordinato
Nella pagina Opzioni Replicat, completare i campi riportati di seguito, quindi fare clic su Avanti:
Per Nome processo, immettere un nome per il processo Replicat.
(Facoltativo) In Descrizione, immettere una breve descrizione per distinguere questo processo dagli altri.
Per Nome trail, immettere il nome del trail di due caratteri.
Per la destinazione, selezionare Oracle Object Storage dall'elenco a discesa.
Per gli alias disponibili per OCI, selezionare l'alias dall'elenco a discesa.
Nella pagina File dei parametri, aggiungere e configurare i parametri Replicat in base alle esigenze, quindi fare clic su Successivo.
Nota
Se si utilizza Replicat coordinato, aggiungere i seguenti parametri sulla seconda riga del file dei parametri:
TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
name>.properties
L'utilizzo di replica coordinata determinerà la creazione di più file.
Se omesso, viene visualizzato il seguente errore:
OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
"/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
directory).
Per impostazione predefinita, GoldenGate utilizza l'ora di Greenwich (GMT, Greenwich Mean Time). Utilizzare SETENV per sostituire l'impostazione predefinita. Ad esempio:
Nella pagina File proprietà, configurare le proprietà Handler di file e Handler di eventi OCI in base alle esigenze, quindi fare clic su Successivo. Di seguito sono riportate alcune delle proprietà da considerare per la modifica.
gg.handler.name.format: selezionare la modalità di formattazione dei dati di output. Le opzioni disponibili includono:
gg.handler.name.fileNameMappingTemplate: genera i nomi dei file in modo dinamico utilizzando Parole chiave modello.
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 in Storage degli oggetti Oracle.
gg.eventhandler.name.compartmentID: immettere l'OCID del compartimento.
gg.eventhandler.name.bucketMappingTemplate: immettere il nome del bucket di storage degli oggetti.
È inoltre possibile aggiungere formatter collegabili in base alle esigenze. Per ulteriori informazioni, vedere Utilizzo dei formatter collegabili.
Fare clic su Aggiungi ed esegui.
Viene visualizzata di nuovo la pagina Panoramica del servizio di amministrazione in cui è possibile monitorare lo stato del processo Replicat. Fare clic sul nome del processo per visualizzarne i dettagli e accedere ai report.
Problemi noti con le connessioni allo storage degli oggetti Oracle
Errore di replica dello storage degli oggetti OCI durante l'uso del principal risorsa
Replicat non riesce con il seguente errore quando si utilizzano connessioni di storage degli oggetti OCI che utilizzano l'autenticazione principal risorsa:
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 OCI (solo utenti federati)
Se un utente federato seleziona Utilizza l'utente corrente durante la creazione di una connessione allo storage degli oggetti OCI, il relativo OCID non corrisponde all'OCID selezionato dal sistema.
Soluzione: quando si crea una connessione allo storage degli oggetti OCI, assicurarsi di scegliere Specificare un altro utente, quindi immettere l'OCID dell'utente federato.
Per trovare l'OCID utente, fare clic su Profilo nell'intestazione globale della console di Oracle Cloud, quindi selezionare il nome utente. Nella pagina Dettagli utente, in Informazioni utente, fare clic su Mostra per OCID.