Aggiungi un Replicat per lo storage degli oggetti OCI

Imparare ad aggiungere e configurare un processo Replicat per una destinazione OCI Object Storage.

Argomenti correlati

Prima di iniziare

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

  • OCID compartimento

    Suggerimento

    Puoi trovare l'OCID del compartimento nella pagina dei dettagli del compartimento.
    1. Aprire il menu di navigazione della console 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 OCI Object Storage

    Suggerimento

    Oracle consiglia di creare il proprio bucket di storage degli oggetti OCI.
    1. Aprire il menu di navigazione della console di Oracle Cloud, selezionare Memorizzazione, quindi Bucket.
    2. Fare clic su Crea bucket.
    3. Nel pannello Crea bucket, immettere un nome e fare clic su Crea.

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

Aggiungi un Replicat (23ai)

Prima di iniziare

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

Per aggiungere un Replicat in GoldenGate 23ai:
  1. Nella console di distribuzione OCI GoldenGate, nella home page di Administration Service, fare clic su Aggiungi Replicat (icona più).
  2. 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.
  3. 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 di checkpoint creata per la distribuzione di destinazione.
      • Selezionare il Numero massimo di thread (solo replicati coordinati).
  4. 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.
  5. 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")
  6. 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.
    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 OCI 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 viene caricato nello storage degli oggetti OCI.
    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

    È inoltre possibile aggiungere formatter collegabili in base alle esigenze. Per ulteriori informazioni, vedere Formatter collegabili.
  7. Fare clic su Crea ed esegui. Se si fa clic su Crea, è possibile avviare manualmente Replicat in un secondo momento dalla home page di Administration Service.

Aggiungi un Replicat (21c)

Per aggiungere un Replicat per una destinazione Storage degli oggetti OCI:
  1. Nella console di distribuzione OCI GoldenGate, nella pagina Panoramica del servizio di amministrazione, fare clic su Aggiungi Replicat (icona più).
  2. 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
  3. Nella pagina Opzioni Replicat, completare i campi riportati di seguito, quindi fare clic su Avanti:
    1. Per Nome processo, immettere un nome per il processo Replicat.
    2. (Facoltativo) In 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 la destinazione, selezionare Oracle Object Storage 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 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:
      setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

      Ulteriori informazioni su SETENV.

  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.
    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 OCI 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 viene caricato nello storage degli oggetti OCI.
    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

    È inoltre possibile aggiungere formatter collegabili in base alle esigenze. Per ulteriori informazioni, vedere Utilizzo dei formatter collegabili.
  6. 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

Errore di replica dello storage degli oggetti OCI durante l'uso del principal risorsa

Se viene utilizzata una principal risorsa per l'autenticazione, Replicat non riuscirà e si verificherà 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

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.