Aggiungi un Replicat per Snowflake

Informazioni sull'aggiunta di un processo Replicat per una destinazione Snowflake in una replica di dati OCI GoldenGate.

Prima di iniziare

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:

    1. Per Replicat Trail:

      • 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

    2. Per posizione trail:

      • Immettere il numero sequenza.

      • Immettere l'offset RBA.

    3. Per Destinazione, selezionare Snowflake dall'elenco a discesa, quindi selezionare una delle opzioni riportate di seguito.

      1. Streaming

      2. Posiziona nell'area intermedia e unisci, quindi seleziona una posizione area intermedia disponibile

    4. Per credenziali di 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. (Facoltativo) Nella pagina Proprietà file, rivedere la proprietà:

    • jvm.bootoptions: aumentare il valore -Xmx se è necessario aggiungere più memoria alla JVM Replicat (-Xmx16g per utilizzare fino a 16 GB di memoria, -Xmx32g per un massimo di 32 GB e così via).

      Nota: un handler di streaming Snowflake correlato a un problema noto non riesce con l'errore Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper". Per risolvere il problema, aggiungere quanto segue al file delle proprietà Replicat:

      jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true

    Per informazioni sulle proprietà di questa destinazione e sulle differenze tra gli handler di fase e unione e streaming, vedere Snowflake nella guida Oracle GoldenGate for Distributed Applications and Analytics.

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

Aggiungi un Replicat (21c)

Per aggiungere un Replicat per Snowflake in Oracle GoldenGate 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. In Nome processo, immettere un nome per il processo Replicat.

    2. In Nome percorso, immettere il nome del trail a due caratteri.

    3. Per Destinazione, selezionare la connessione Snowflake di destinazione dall'elenco a discesa.

    4. Per Alias disponibili, selezionare l'alias dall'elenco a discesa.

    5. (Facoltativo) Abilita storage esterno per selezionare una posizione area intermedia disponibile dall'elenco a discesa.

  4. Nella pagina Parametri replica aggiungere i mapping necessari, quindi selezionare Successivo.

    Nota:

    • Se si utilizza Replicat coordinato, aggiungere i seguenti parametri nella seconda riga del file dei parametri:
    TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/.properties

    L'utilizzo di replicat coordinato comporterà la creazione di più file. Se omesso, si verificherà il seguente errore:

    OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file "/u02/Deployment/etc/conf/ogg/001.properties" (error 2, No such file or directory).

    • Se sono presenti operazioni di unione con tempi di esecuzione lunghi in Snowflake e viene osservato un numero elevato di blocchi, assicurarsi che nessun'altra tabella modifichi la stessa tabella. Inoltre, utilizzare replicato coordinato con cautela in quanto può portare a un numero elevato di blocchi da tavolo.

    • 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")

    Ulteriori informazioni su SETENV.

  5. (Facoltativo) Nella pagina Proprietà file, rivedere le proprietà riportate di seguito.

    Nota: queste proprietà vengono impostate quando è stata creata la connessione e non devono essere modificate qui.

    • ggs.eventhandler.snowflake.connectionURL: URL JDBC per la connessione a Snowflake.

    • ggs.eventhandler.snowflake.UserName: nome utente del database Snowflake.

    • ggs.eventhandler.snowflake.Password: password associata all'utente del database Snowflake.

    • ggs.eventhandler.snowflake.storageIntegration: la credenziale per il data warehouse Snowflake per accedere ai rispettivi file dell'area di memorizzazione degli oggetti. Per ulteriori informazioni, vedere Integrazione dello storage Snowflake.

    • jvm.bootoptions: aumentare il valore -Xmx se è necessario aggiungere più memoria alla JVM Replicat (-Xmx16g per utilizzare fino a 16 GB di memoria, -Xmx32g per un massimo di 32 GB e così via).

  6. Selezionare Crea ed esegui. Se si seleziona Crea, è possibile avviare manualmente Replicat in un secondo momento dalla pagina Panoramica del servizio di amministrazione.

Si torna alla pagina Panoramica del servizio di amministrazione, in cui è possibile visualizzare la creazione del processo Replicat e accedere ad Azioni Replicat.

Contenuto correlato

Problemi noti

Bug 37518857: errore OGGDAA GGS Snowflake Streaming Replicat

Snowflake Streaming Handler fallisce con: Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

Soluzione: aggiungere quanto segue al file Replicat Properties:

jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true