Aggiungi un percorso di distribuzione

Un percorso di distribuzione invia la transazione dei dati da un'estrazione a un Replicat.

Argomenti correlati

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 creano automaticamente un percorso del destinatario nel servizio del destinatario della distribuzione di destinazione. Il percorso del destinatario riceve la transazione dei dati dal servizio di distribuzione di origine.

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

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 destinatario avviato dalla destinazione.

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

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

Crea ed esegui un percorso di distribuzione (23ai)

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 target eseguire il login, quindi accedere alla pagina Amministrazione utenti dalla navigazione a sinistra.
  2. Fare clic su Aggiungi nuovo utente, quindi completare quanto riportato di seguito.
    • Autenticato da: selezionare Password dall'elenco a discesa.
    • Ruolo: selezionare Operatore nell'elenco a discesa.
    • Nome utente: immettere il nome utente.
    • Password e Verify Password: immettere la password associata a questo utente.
  3. Aprire la console di distribuzione origine, quindi passare a Connessioni percorso nel menu di navigazione a sinistra.
  4. Fare clic su Add Path Connection, quindi completare le operazioni riportate di seguito.
    • Alias credenziale: immettere un alias.
    • ID utente: immettere il nome dell'utente creato nel passo 2.
    • Password e Verify Password: immettere la password associata a questo utente dal passo 2.
  5. Fare clic su Sottometti.
Per aggiungere un percorso di distribuzione in GoldenGate 23ai:
  1. Nella console di distribuzione OCI GoldenGate, fare clic su Servizio di distribuzione.
  2. Nella home page, fare clic su Aggiungi percorso di distribuzione (icona più).
  3. Nel pannello Aggiungi percorso, completare i campi Informazioni percorso in base alle esigenze, quindi fare clic su Avanti:
    1. Immettere il nome del percorso, 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.
  4. Nella pagina Opzioni origine, immettere i campi in base alle esigenze, quindi fare clic su Successivo.
    • Selezionare Estrazione origine dall'elenco a discesa.
    • Immettere il nome del percorso
    • Immettere la sottodirectory se si prevede che il trail si trovi in una posizione diversa da quella predefinita.
    • L'URI origine generato viene generato automaticamente in base alle informazioni fornite. Fare clic su Modifica (icona a forma di matita) per modificare l'URI, se necessario.
    • Selezionare un profilo di cifratura. Se non è stato creato un profilo di cifratura, per impostazione predefinita viene selezionato il profilo Wallet locale.
    • Per Inizia, selezionare il punto di partenza per l'elaborazione dei dati:
      • Posizione nel log
      • Now
      • Orario personalizzato
      • CSN (in corrispondenza o dopo)
    • Immettere il numero di sequenza.
    • Immettere l'offset RBA.
  5. Nella pagina Opzioni di destinazione, completare i campi in base alle esigenze, quindi fare clic su Successivo:
    • Selezionare un protocollo di destinazione:
      • ws
      • wss
      • ogg
    • (Opzionale) Abilitare Proxy inverso abilitato per connettersi alla destinazione utilizzando un proxy inverso.
    • Tipo di destinazione (solo protocollo di destinazione OGG)
      • Responsabile
      • Collector
      • Servizio di ricezione
    • Immettere l'host di destinazione.
    • Immettere il numero di porta della distribuzione di destinazione.
    • Immettere il Nome percorso per il file trail di destinazione.
    • Immettere la sottodirectory se il trail si trova in un punto diverso dalla posizione predefinita.
    • 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 le modifiche all'algoritmo di cifratura.
    • L'URI di destinazione generato viene generato automaticamente in base alle informazioni fornite. Fare clic su Modifica (icona a forma di matita) per modificare l'URI, se necessario.
    • Selezionare un metodo di autenticazione di 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 di 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 l'alias con Oracle GoldenGate UserID e la password.
    • Selezionare un tipo di destinazione:
      • GGFormat (predefinito)
      • SQL
      • XML
      • Testo non codificato
  6. Nella pagina Opzioni avanzate, completare i campi in base alle esigenze, quindi fare clic su Avanti:
    • Abilitare Abilita compressione di rete per impostare la soglia di compressione.
    • Selezionare EOF Delay.

      Nota

      Sulle piattaforme Linux, le impostazioni predefinite possono essere mantenute. Tuttavia, su piattaforme non Linux, potrebbe essere necessario regolare questa impostazione per reti ad alta larghezza di banda, ad alta latenza o per reti che dispongono di impostazioni per la qualità del servizio (QoS) (DSCP e Time of Service (ToS))
    • Selezionare Frequenza checkpoint per impostare la frequenza del percorso che sta eseguendo il checkpoint (in secondi).
    • Immettere TCP Flush Bytes (in byte).
    • Immettere il valore in Flush TCP in secondi (in secondi).
    • Selezionare il punto codice servizi differenziati (DSCP).
    • Selezionare il tipo di servizio (TOS).
    • Abilitare TCP_NODELAY per evitare ritardi quando si utilizza l'opzione di Nagle.
    • Abilitare ACK rapido per inviare una conferma rapida dopo aver ricevuto i dati.
    • Abilitare TCP_CORK per consentire l'utilizzo dell'opzione di sughero dell'algoritmo di Nagle.
    • Immettere la dimensione del buffer di invio del sistema per impostare il valore della dimensione del buffer di invio per il controllo del flusso.
    • Immettere la dimensione del buffer di ricezione del sistema per impostare il valore della dimensione del buffer di ricezione per il controllo del flusso.
    • Impostare il timeout per Continua.
  7. Nella pagina Opzioni di filtro, completare i campi riportati di seguito in base alle esigenze, quindi fare clic su Successivo:
    • Immettere un 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 seguenti: DML, DDL e procedura
      • Nomi oggetto: selezionare questa opzione per fornire un nome oggetto esistente. Una convenzione di denominazione in 3 parti dipende dall'utilizzo del CDB. Con CDB, è necessario utilizzare una convenzione di denominazione in 3 parti, altrimenti è obbligatoria una convenzione in 2 parti. La convenzione in 3 parti include container, schema, object. La convenzione in 2 parti include schema, object name.
      • Nome funzione procedura: selezionare questa opzione per filtrare in base al nome di 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 inserire nei dati filtrati prima o dopo l'immagine.
      • Tag: selezionare questa opzione per impostare il filtro in base alle tag.
      • ID chunk: visualizza i dettagli di configurazione delle partizioni del database, ma non è possibile modificarli.
    • Selezionare Nega per negare qualsiasi regola esistente.
    • Fare clic su Aggiungi per aggiungere la regola.
  8. Nella pagina Opzioni gestite, completare i campi facoltativi in base alle esigenze.
    • Abilitare Critico per configurare questo percorso per l'alta disponibilità.
    • Abilitare Riavvio automatico per regolare i tentativi di riavvio automatico e le opzioni di ritardo del riavvio automatico.
  9. Fare clic su Crea ed esegui per eseguire immediatamente il percorso. Fare clic su 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 della destinazione, eseguire il login, quindi accedere alla pagina Amministratore dal menu di navigazione.
  2. Fare clic su Aggiungi utente, quindi creare un utente che la distribuzione di origine può utilizzare per connettersi alla distribuzione di destinazione. Assegnare all'utente il ruolo Operatore.
  3. Aprire la console di distribuzione di origine, quindi passare alla pagina Configurazione.
  4. Nella scheda Database fare clic su Aggiungi credenziale, quindi completare le operazioni riportate di seguito.
    • Dominio credenziali: immettere un nome per questa connessione.
    • Alias credenziale: immettere un alias.
    • ID utente: immettere il nome dell'utente creato nel passo 2.
    • Password e Verify Password: immettere la password associata a questo utente dal passo 2.
  5. Fare clic su Sottometti.
Per aggiungere un percorso di distribuzione:
  1. Nella console di distribuzione OCI GoldenGate, fare clic su Servizio di distribuzione.
  2. Nella pagina Panoramica del servizio di distribuzione fare clic su Aggiungi percorso (icona più).
  3. Nella pagina Aggiungi percorso, completare i campi come indicato di seguito.
    1. Per Nome percorso, immettere un nome per il percorso.
    2. (Facoltativo) In Descrizione, inserire una breve descrizione sullo scopo del percorso.
    3. (Opzionale) Abilitare Proxy inverso abilitato per connettersi alla destinazione utilizzando un proxy inverso.
    4. Per Origine, selezionare il nome dell'estrazione dall'elenco a discesa.
    5. Per Nome percorso, selezionare il trail Estrai dall'elenco a discesa.
    6. Per URI di origine generato, l'URI viene generato automaticamente in base alle informazioni sull'estrazione fornite. Fare clic su Modifica (icona a forma di matita) per modificare l'URI, se necessario.
    7. Per Metodo di autenticazione della destinazione, selezionare il metodo di autenticazione per l'URI della 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 UserID: questa opzione utilizza un alias UserID che è possibile creare nella destinazione Oracle GoldenGate 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 di identità IAM.
    8. Per Destinazione, selezionare un protocollo di trasferimento dati dall'elenco a discesa:
      • wss: l'opzione di sicurezza del socket Web è quella predefinita. Se si seleziona questa opzione, è necessario completare i campi riportati di seguito.
        • Host di destinazione
        • Numero porta
        • Nome trail
        • Nome distribuzione (proxy inverso abilitato)
        • Percorso URI (proxy inverso abilitato)
        • Dominio
        • un alias.
      • ogg: se si seleziona, è necessario completare i campi riportati di seguito.
        • Host di destinazione
        • Numero porta
        • Nome trail
        • Nome distribuzione (proxy inverso abilitato)
        • Percorso URI (proxy inverso abilitato)
      • ws: se selezionata, è necessario completare i seguenti campi:
        • Host di destinazione
        • Numero porta
        • Nome trail
        • Nome distribuzione (proxy inverso abilitato)
        • Percorso URI (proxy inverso abilitato)
        • Dominio
        • un alias.
    9. Per l'URI di destinazione generato, l'URI viene popolato automaticamente dalle informazioni fornite. Fare clic su 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 di rete, selezionare questa opzione per impostare la soglia di compressione.
    12. In Lunghezza sequenza, immettere la lunghezza del numero di sequenza del trail.
    13. Per Dimensione percorso (MB), immettere la dimensione massima per 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 (impostazione predefinita)
    5. Per Numero sequenza di origine, selezionare il numero di sequenza della distribuzione di origine del file trail Extract.
    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 terminato.
    9. Per le opzioni di riavvio automatico, indicare il numero di tentativi di riavvio del processo di percorso e l'intervallo di tempo di 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, fare clic su Aggiungi regola, quindi completare i campi aggiuntivi.
  6. In Altre opzioni, completare i campi riportati di seguito in base alle esigenze.
    1. Ritardo EOF: fine del ritardo del file prima della ricerca dei dati di origine
    2. Frequenza checkpoint: frequenza in secondi per i checkpoint di routine
    3. Opzioni applicazione
      • byte flush TCP: dimensione flush
      • Flush TCP Secondo: Intervallo di flush
    4. Opzioni TCP
      • DSCP: servizi differenziati di rete
      • Termini di servizio TOS
      • TCP_NODELAY: disabilita l'uso dell'algoritmo di Nagle se abilitato
      • ACK rapido: invia conferma se abilitata
      • TCP_CORK: consente l'uso dell'algoritmo di Nagle
      • Dimensione buffer di invio del sistema
      • Dimensione buffer di ricezione del sistema
      • Keep Alive: timeout per mantenere vivo
  7. Fare clic su Crea ed esegui.
Si torna alla pagina Panoramica in cui è possibile visualizzare lo stato del processo Percorso.

Ulteriori informazioni

Vuoi saperne di più sul processo Percorso di distribuzione? Consultare le seguenti risorse:

Problemi noti

Per creare percorsi di distribuzione per l'invio o il pull dei dati da Oracle Cloud Infrastructure GoldenGate, assicurarsi di aggiungere il certificato radice a Gestione certificati o al wallet client

Per inviare o estrarre dati da OCI GoldenGate, è necessario creare un percorso del server di distribuzione o un percorso avviato di destinazione sul server ricevente rispettivamente in Oracle GoldenGate on premise o nel Marketplace. È inoltre necessario aggiungere il certificato radice OCI GoldenGate o il certificato autofirmato a Oracle GoldenGate Certificate Management (Oracle GoldenGate 21c o versione successiva) o al wallet client (Oracle GoldenGate 19c). In questo modo viene creata una connessione sicura tra le distribuzioni Oracle GoldenGate e OCI GoldenGate. Per i percorsi server di distribuzione e di ricezione tra Oracle GoldenGate e OCI GoldenGate è supportato solo il protocollo WebSocket Secure (WSS).

Una modifica del certificato radice OCI GoldenGate provocherà l'errore del percorso del server di distribuzione o di un percorso avviato di destinazione nel server ricevente in locale o nel Marketplace Oracle GoldenGate e produrrà il seguente errore:

ERROR   OGG-10390  Oracle GoldenGate Receiver Service:  Generic error -1 noticed for endpoint
      wss://<deployment URL>:443/services/v2/sources?trail=<trail name>. Error description - SSL
      connection unexpectedly closed.

Soluzione: per risolvere questo problema, aggiornare il certificato nel wallet client o nella schermata Gestione certificati di Service Manager in modo da utilizzare il certificato radice della console di distribuzione GoldenGate OCI. In alcuni casi, quando il certificato della distribuzione GoldenGate OCI non è firmato direttamente dal certificato radice, ma da uno o più certificati intermedi, ad esempio, potrebbe essere necessario aggiungere anche i certificati CA intermedi.

Ulteriori informazioni:

Attualmente è supportata solo l'autenticazione Digest

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

Soluzione: nessuna.