Aggiungi percorso di distribuzione

Un percorso di distribuzione invia la transazione di dati da un Extract a un Replicat.

Quando utilizzare un percorso di distribuzione

Utilizzare un percorso di distribuzione quando è necessario replicare i dati in un ambiente di distribuzione distribuito. Un percorso di distribuzione invia la transazione dei dati dall'estrazione al Replicat. La creazione e l'esecuzione di un percorso di distribuzione crea automaticamente un percorso di ricezione nel servizio di ricezione della distribuzione di destinazione. Il percorso del ricevente riceve la transazione di dati dal servizio di distribuzione della distribuzione di origine.

La distribuzione di origine è la distribuzione in cui si crea il percorso di distribuzione. La distribuzione di destinazione è la distribuzione alla quale vengono inviati i dati e i percorsi estratti.

Prima di iniziare

Assicurarsi di creare connessioni GoldenGate per ogni distribuzione a cui si desidera connettersi, quindi assegnarle alla distribuzione da cui ha origine il percorso. Ad esempio, la distribuzione in cui si crea il percorso di distribuzione o il percorso di ricezione avviato dalla destinazione.

In caso contrario, nelle distribuzioni abilitate per IAM si verificherà l'errore riportato di seguito.

The network connection could not be established: 'OGG-08654' - 'Invalid or missing OAuth
      resource - audiencescope in Client application'.

Creare ed eseguire un percorso di distribuzione (26ai)

Se si utilizza l'area di memorizzazione delle credenziali GoldenGate, è necessario aggiungere un utente utilizzato dalla distribuzione di origine per connettersi a una distribuzione di destinazione. Se si utilizza l'area di memorizzazione delle credenziali IAM, saltare questi passi.

  1. Nella console di distribuzione destinazione eseguire il login, quindi accedere alla pagina Amministrazione utenti dalla navigazione a sinistra.

  2. Selezionare Aggiungi nuovo utente, quindi completare quanto riportato di seguito.

    • Autenticato da: selezionare Password dall'elenco a discesa.

    • Ruolo: selezionare Operatore dall'elenco a discesa.

    • Nome utente: immettere il proprio nome utente.

    • Password e Verifica password: immettere la password associata all'utente.

  3. Aprire la console di distribuzione origine, quindi passare a Connessioni percorso nel menu di navigazione a sinistra.

  4. Selezionare Aggiungi connessione percorso, quindi completare quanto riportato di seguito.

    • Alias credenziale: immettere un alias.

    • ID utente: immettere il nome dell'utente creato nel passo 2.

    • Password e Verifica password: immettere la password associata a questo utente dal passo 2.

  5. Selezionare Sottometti.

Per aggiungere un percorso di distribuzione in GoldenGate 26ai, effettuare le operazioni riportate di seguito.

  1. Nella home page della console di distribuzione OCI GoldenGate, selezionare Crea (icona più) per i percorsi di distribuzione.

  2. Nel pannello Aggiungi percorso, completare i campi Informazioni percorso in base alle esigenze, quindi selezionare Successivo:

    1. Immettere il Nome percorso, quindi immettere un nome per il percorso.

    2. (Facoltativo) Immettere una Descrizione per descrivere lo scopo di questo percorso ed elencare le estrazioni e le repliche coinvolte.

  3. Nella pagina Opzioni di origine immettere i campi in base alle esigenze, quindi selezionare Successivo.

    • Selezionare l'opzione Estrazione origine dall'elenco a discesa.

    • Immettere il nome del percorso

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

    • L'URI di origine generato viene generato automaticamente in base alle informazioni fornite. Selezionare Modifica (icona a forma di matita) per modificare l'URI, se necessario.

    • Selezionare un profilo di cifratura. Il profilo Wallet locale viene selezionato per impostazione predefinita se non è stato creato un profilo di cifratura.

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

      • Posizione nel log

      • Now

      • Orario personalizzato

      • CSN (in corrispondenza o dopo)

    • Immettere il numero sequenza.

    • Immettere l'offset RBA.

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

    • Selezionare un protocollo di destinazione:

      • ws

      • wss

      • ogg

    • (Facoltativo) Abilitare Storna proxy abilitato per connettersi alla destinazione utilizzando un proxy inverso.

    • Tipo di destinazione (solo protocollo di destinazione variabile)

      • Responsabile

      • Collector

      • Servizio di ricezione

    • Immettere l'host di destinazione.

    • Immettere il numero porta della distribuzione di destinazione.

    • Immettere il Nome percorso per il file trail di destinazione.

    • Immettere la sottodirectory se il percorso trail si trova in un punto diverso da quello predefinito.

    • Immettere la dimensione percorso massima.

    • Selezionare un algoritmo di cifratura di destinazione utilizzato per inviare il trail alla distribuzione di destinazione:

      • NONE

      • AES128

      • AES192

      • AES256

    • Abilitare Modifica cifratura per consentire modifiche all'algoritmo di cifratura.

    • L'URI di destinazione generato viene generato automaticamente in base alle informazioni fornite. Selezionare Modifica (icona a forma di matita) per modificare l'URI, se necessario.

    • Selezionare un metodo di autenticazione destinazione (solo protocollo di destinazione wss)

      • Alias ID utente

        Nota: creare una credenziale utilizzando l'utente IAM durante la connessione a una distribuzione abilitata per IAM da una distribuzione dell'area di memorizzazione delle credenziali GoldenGate. Assicurarsi che l'utente esista nello striping identità IAM.

      • OAuth

        Nota: nelle tenancy abilitate per IAM, selezionare OAuth durante la connessione a un'altra distribuzione abilitata per IAM.

      • Certificato

    • Selezionare un dominio.

    • Selezionare le alias con ID utente e password Oracle GoldenGate.

    • Selezionare un tipo di destinazione:

      • GGFormat (predefinito)

      • SQL

      • XML

      • Testo non codificato

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

    • Abilitare Abilita compressione di rete per impostare la soglia di compressione.

    • Selezionare EOF Delay.

      Nota: nelle piattaforme Linux è possibile mantenere le impostazioni predefinite. Tuttavia, su piattaforme non Linux, potrebbe essere necessario modificare questa impostazione per reti a elevata larghezza di banda e latenza o per reti con impostazioni QoS (Quality of Service, QoS) (DSCP e Time of Service, ToS))

    • Selezionare Frequenza checkpoint per impostare la frequenza del percorso che sta prendendo il checkpoint (in secondi).

    • Immettere i byte di flush TCP (in byte).

    • Immettere i secondi di flush TCP (in secondi).

    • Selezionare il punto codice dei servizi differenziati (DSCP).

    • Selezionare il tipo di servizio (TOS).

    • Abilitare TCP_NODELAY per evitare ritardi quando si utilizza l'opzione Nagle.

    • Abilitare ACK rapido per inviare una conferma rapida dopo la ricezione dei dati.

    • Abilitare TCP_CORK per consentire l'utilizzo dell'opzione di sughero dell'algoritmo di Nagle.

    • Immettere Dimensione buffer invio sistema per impostare il valore per la dimensione del buffer di invio per il controllo del flusso.

    • Immettere la Dimensione buffer ricezione sistema per impostare il valore della dimensione del buffer di ricezione per il controllo del flusso.

    • Impostare il timeout per Keep Alive.

  6. Nella pagina Opzioni di filtro, completare i campi riportati di seguito in base alle esigenze, quindi selezionare Successivo.

    • Inserire un valore in Nome regola.

    • Selezionare un'azione regola:

      • Escludi filtra i dati in base alle opzioni selezionate.

      • Includi include i dati in base alle opzioni specificate.

    • Selezionare un tipo di filtro:

      • Tipo di oggetto: selezionare uno dei tre tipi di oggetto DML, DDL e Procedura.

      • Nomi oggetto: selezionare questa opzione per fornire un nome oggetto esistente. Una convenzione di denominazione a 3 parti dipende dall'utilizzo del CDB. Con CDB, è necessario utilizzare una convenzione di denominazione a 3 parti, altrimenti è obbligatoria una convenzione a 2 parti. La convenzione a 3 parti include container, schema, object. La convenzione a 2 parti include schema, object name.

      • Nome funzione procedura: selezionare questa opzione per filtrare in base al nome della funzione della procedura esistente.

      • Basato su colonna: se si seleziona questa opzione, viene visualizzata l'opzione per immettere il nome della tabella e della colonna a cui si applica la regola. È possibile filtrare utilizzando il valore della colonna con LE condizioni LT, GT, EQ, LE, GE, NE. È inoltre possibile specificare se si desidera avere prima dell'immagine o dopo l'immagine nei dati filtrati.

      • Tag: selezionare questa opzione per impostare il filtro in base alle tag.

      • ID chunk: visualizza i dettagli di configurazione delle partizioni del database, ma i dettagli non possono essere modificati.

    • Selezionare Negate per negare qualsiasi regola esistente.

    • Per aggiungere la regola, selezionare Aggiungi.

  7. Nella pagina Opzioni gestite completare i campi facoltativi in base alle esigenze.

    • Abilitare Critica per configurare questo percorso per l'alta disponibilità.

    • Abilitare Riavvio automatico per regolare i nuovi tentativi di riavvio automatico e le opzioni di ritardo del riavvio automatico.

  8. Selezionare Crea ed esegui per eseguire immediatamente il percorso. Selezionare Crea per eseguire il percorso manualmente in un secondo momento.

Si torna alla home page in cui è possibile visualizzare lo stato del processo Percorso.

Creare ed eseguire un percorso di distribuzione (21c)

Aggiungere una credenziale che consenta a una distribuzione di origine (la distribuzione in cui si crea questo percorso) di connettersi a una distribuzione di destinazione:

  1. Nella console di distribuzione di destinazione, eseguire il login, quindi accedere alla pagina Amministratore dal menu di navigazione.

  2. Selezionare Aggiungi utente, quindi creare un utente che la distribuzione di origine possa utilizzare per connettersi alla distribuzione di destinazione. Assegnare a questo utente il ruolo Operatore.

  3. Aprire la console di distribuzione di origine, quindi passare alla pagina Configurazione.

  4. Nella scheda Database selezionare Aggiungi credenziale, quindi completare quanto riportato di seguito.

    • Dominio credenziale: immettere un nome per questa connessione.

    • Alias credenziale: immettere un alias.

    • ID utente: immettere il nome dell'utente creato nel passo 2.

    • Password e Verifica password: immettere la password associata a questo utente dal passo 2.

  5. Selezionare Sottometti.

Per aggiungere un percorso di distribuzione:

  1. Nella console di distribuzione OCI GoldenGate, selezionare Servizio di distribuzione.

  2. Nella pagina Panoramica servizio di distribuzione, selezionare Aggiungi percorso (icona più).

  3. Nella pagina Aggiungi percorso, completare i campi come indicato di seguito.

    1. In Nome percorso, immettere un nome per il percorso.

    2. (Facoltativo) In Descrizione, immettere una breve descrizione dello scopo del percorso.

    3. (Facoltativo) Abilitare Storna proxy abilitato per connettersi alla destinazione utilizzando un proxy inverso.

    4. In Origine, selezionare il nome dell'estrazione dall'elenco a discesa.

    5. In Nome percorso, selezionare lo storico estrazione dall'elenco a discesa.

    6. Per l'URI di origine generato, l'URI viene generato automaticamente in base alle informazioni di estrazione fornite. Selezionare Modifica (icona a forma di matita) per modificare l'URI, se necessario.

    7. Per Metodo di autenticazione di destinazione, selezionare il metodo di autenticazione per l'URI di destinazione.

      • OAuth: selezionare questa opzione se le distribuzioni di origine e destinazione sono abilitate per IAM. Questa opzione utilizza le credenziali client per l'autenticazione dal servizio di distribuzione al servizio ricevente.

        Nota: nelle tenancy abilitate per IAM, selezionare OAuth durante la connessione a un'altra distribuzione abilitata per IAM.

      • Alias ID utente: questa opzione utilizza un alias ID utente che è possibile creare in Oracle GoldenGate di destinazione per stabilire una connessione.

        Nota: creare una credenziale utilizzando l'utente IAM durante la connessione a una distribuzione abilitata per IAM da una distribuzione dell'area di memorizzazione delle credenziali GoldenGate. Assicurarsi che l'utente esista nello striping identità IAM.

    8. Per Destinazione, selezionare un protocollo di trasferimento dati dall'elenco a discesa:

      • wss: l'opzione predefinita è la protezione del socket Web. Se selezionata, è necessario completare i seguenti campi:

        • Host di destinazione

        • Numero porta

        • Nome trail

        • Nome distribuzione (reverse proxy abilitato)

        • Percorso URI (reverse proxy abilitato)

        • Dominio

        • un alias.

      • Attiva/disattiva: se si seleziona, è necessario completare i campi riportati di seguito.

        • Host di destinazione

        • Numero porta

        • Nome trail

        • Nome distribuzione (reverse proxy abilitato)

        • Percorso URI (reverse proxy abilitato)

      • ws: se selezionata, è necessario completare i seguenti campi:

        • Host di destinazione

        • Numero porta

        • Nome trail

        • Nome distribuzione (reverse proxy abilitato)

        • Percorso URI (reverse proxy abilitato)

        • Dominio

        • un alias.

    9. Per URI destinazione generata, l'URI viene popolato automaticamente dalle informazioni fornite. Selezionare Modifica (icona a forma di matita) per modificare l'URI, se necessario.

    10. Per l'algoritmo di cifratura di destinazione, selezionare un algoritmo di cifratura per il trail di destinazione:

      • Nessuno.

      • AES128

      • AES192

      • AES256

    11. Per Abilita compressione rete, selezionare questa opzione per impostare la soglia di compressione.

    12. Per Lunghezza sequenza, immettere la lunghezza del numero di sequenza trail.

    13. In Dimensione percorso (MB), immettere la dimensione massima di un file in un trail.

    14. Per Configura formato trail, abilitare questa opzione se si desidera configurare il formato del file trail, quindi completare i campi aggiuntivi in base alle esigenze.

  4. Nella sezione Profilo di cifratura, completare i campi riportati di seguito in base alle esigenze.

    1. Nome profilo

    2. Tipo di profilo di cifratura

    3. Nome chiave primaria

    4. Per Inizia, selezionare la posizione in cui registrare i dati:

      • Now

      • Orario personalizzato

      • Posizione nel log (predefinito)

    5. In Numero sequenza origine, selezionare il numero di sequenza dell'estrazione della distribuzione dell'origine del file trail.

    6. Per Offset RBA di origine, immettere l'indirizzo RBA (Relative Byte Address) nel file trail in cui si desidera avviare il processo.

    7. Per Critico, impostare questa opzione su True se il percorso di distribuzione è critico per la distribuzione. L'impostazione predefinita è False.

    8. Per Riavvio automatico, impostare questa opzione su True se si desidera che il percorso di distribuzione venga riavviato automaticamente se viene interrotto.

    9. Per le opzioni di riavvio automatico, indicare il numero di nuovi tentativi per riavviare il processo di percorso e l'intervallo di durata del ritardo tra i nuovi tentativi.

  5. In Configurazione set di regole, completare i campi riportati di seguito in base alle esigenze.

    1. Per Abilita filtro, se selezionata, selezionare Aggiungi regola, quindi completare i campi aggiuntivi.

  6. In Altre opzioni, completare i campi riportati di seguito in base alle esigenze.

    1. Ritardo EOF: ritardo alla fine del file prima di cercare i dati di origine

    2. Frequenza checkpoint: frequenza in secondi per i checkpoint di routine

    3. Opzioni applicazione

      • Byte di flush TCP: dimensione flush

      • Secondi di svuotamento TCP: intervallo di svuotamento

    4. Opzioni TCP

      • DSCP: servizi differenziati di reti

      • Termine del servizio TOS

      • TCP_NODELAY: disabilita l'uso dell'algoritmo di Nagle se abilitato

      • ACK rapido: invia conferma se abilitata

      • TCP_CORK: abilita l'uso dell'algoritmo di Nagle

      • Dimensione del buffer di invii al sistema

      • Dimensione buffer di ricezione del sistema

      • Keep Alive: timeout per il controllo attivo

  7. Selezionare Crea ed esegui.

Si torna alla pagina Panoramica in cui è possibile visualizzare lo stato del processo Percorso.

Ulteriori informazioni

Sei interessato a saperne di più sul processo Percorso di distribuzione? Consultare le seguenti risorse:

Problemi noti

I percorsi di distribuzione e ricezione potrebbero non riuscire dopo l'aggiornamento delle distribuzioni 21.x alla versione 21.17

A partire dalle versioni 21.17 e 26ai di Oracle GoldenGate, i percorsi utilizzano il nome di dominio riservato predefinito, "Rete", in modo che i percorsi esistenti che utilizzano qualsiasi altro nome di dominio non riescano con il seguente errore riportato:

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

Soluzione: nella console di distribuzione OCI GoldenGate, modificare ogni percorso e cambiare il nome di dominio in "Rete", quindi riavviare il percorso. Per verificare, controllare il dominio dell'utente di autenticazione del percorso nella sezione Area di memorizzazione delle credenziali della pagina Configurazione.

Se si preferisce utilizzare Admin Client, eseguire i comandi seguenti per aggiornare il nome di dominio. Assicurarsi di sostituire i segnaposto <path_name> e <alias>:

Per i percorsi avviati dall'origine:

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

Per i percorsi avviati dalla destinazione:

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

Al momento è supportata solo l'autenticazione digest

Oracle Cloud Infrastructure GoldenGate attualmente non supporta l'autenticazione basata su certificati quando si utilizza Oracle Cloud Infrastructure GoldenGate come destinazione del percorso di distribuzione.

Soluzione: nessuna.