Crea risorse pipeline

Imparare a creare le risorse necessarie per utilizzare le pipeline.

Argomenti correlati

Crea connessioni

OCI GoldenGate Pipelines attualmente supporta solo i database AI Autonomous di Oracle con endpoint dedicati e autenticazione mTLS. Per ottenere risultati ottimali, utilizza Autonomous AI Transaction Processing come database di origine e Autonomous AI Lakehouse come database di destinazione.

Prima di creare una pipeline, assicurarsi di preparare il database per GoldenGate, quindi di creare connessioni ai database di origine e di destinazione. Vedere Connettersi a Oracle Autonomous AI Database.

Creare pipeline

Prima di iniziare
Assicurati di:
  • Rivedere e configurare l'univocità delle righe nelle tabelle di database per evitare problemi di chiave primaria con il mirroring ZeroETL. Le chiavi primarie identificano in modo univoco un record o una riga in una tabella di database. Vedere Garantire l'univocità delle righe nelle tabelle di origine e di destinazione.
  • In qualità di utente con privilegi di amministratore per il database di destinazione, concedere i seguenti privilegi all'utente GGADMIN per il mirroring ZeroETL:
    GRANT DWROLE TO GGADMIN;
GRANT DATAPUMP_CLOUD_EXP TO GGADMIN;
GRANT DATAPUMP_CLOUD_IMP TO GGADMIN;
GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO GGADMIN;
GRANT CREATE DATABASE LINK TO GGADMIN;
  • Controllare la vista DBA_GOLDENGATE_SUPPORT_MODE nel database di origine che visualizza informazioni sul livello di supporto del processo di acquisizione Oracle GoldenGate per le tabelle nel database.
  • Aggiungere i criteri minimi richiesti per le pipeline GoldenGate.
  • Le connessioni di origine e di destinazione utilizzate per la pipeline hanno endpoint dedicati.
Per creare una pipeline:
  1. Nella pagina Panoramica OCI GoldenGate, nel menu GoldenGate, fare clic su Pipeline.

    In alternativa, è possibile fare clic su Fabric dati, quindi su Crea pipeline.

  2. Nella pagina Pipeline fare clic su Crea pipeline.
  3. Nel pannello Crea pipeline, completare i campi come indicato di seguito, quindi fare clic su Crea pipeline:
    1. Per Nome, immettere un nome per la pipeline.
    2. (Facoltativo) In Descrizione, immettere una descrizione per facilitare la distinzione tra questa pipeline e le altre.
    3. Per Compartimento, selezionare il compartimento in cui creare la pipeline.
    4. Selezionare un tipo di licenza.
    5. Selezionare le connessioni di origine e di destinazione dagli elenchi a discesa.

      Nota

      Le pipeline attualmente supportano solo le connessioni con endpoint dedicati.
    6. (Facoltativo) Fare clic su Mostra opzioni avanzate per configurare le opzioni del processo.
      • Copia dati esistenti prima della replica in corso: selezionare questa opzione per eseguire un caricamento iniziale dei dati. Per le tabelle esistenti, è possibile scegliere di:
        • Tronca: elimina le righe esistenti, quindi carica le righe dall'origine.
        • Sostituisci: elimina la tabella esistente, la crea e la carica dall'origine.
        • Aggiungi: lascia invariate le righe esistenti e carica le righe dall'origine.
        • Ignora: lascia invariata la tabella e passa all'oggetto successivo.
      • Sostituisci modifiche allo schema (DDL): se si seleziona questa opzione, scegliere l'azione da eseguire sugli schemi esistenti quando il processo rileva un errore:
        • Termina: esegue il rollback della transazione e interrompe l'elaborazione.
        • Elimina: registra l'errore nel file degli elementi eliminati e continua l'elaborazione.
        • Ignora: ignora l'errore e continua l'elaborazione.
      • Azione in caso di errore DML: selezionare l'azione da eseguire sui dati esistenti quando il processo rileva un errore DML.
        • Arresta
        • Elimina
        • Ignora
      • Riavvia dopo un errore: selezionare questa opzione per abilitare l'avvio automatico nel caso in cui il processo si interrompa per qualsiasi motivo.
      • Avvia pipeline utilizzando il mapping predefinito: avvia la pipeline subito dopo la creazione con le regole di mapping 1:1 predefinite. Se non è selezionata, è possibile configurare i mapping delle regole dopo la creazione, quindi avviare manualmente la pipeline.

Aggiungi regole di mapping

Per visualizzare in anteprima, aggiungere o rimuovere le regole di mapping, effettuare le operazioni riportate di seguito.
  1. Nella pagina delle informazioni sulla pipeline selezionare Regole di mapping.
  2. Nell'elenco Regole mapping è possibile rivedere o modificare le regole di mapping correnti e:
    • Anteprima: esaminare il modo in cui le regole di mapping influiscono sugli schemi e sulle tabelle inclusi nella replica.
    • Aggiungi: identifica le tabelle e gli schemi da includere o escludere. È possibile utilizzare il nome o i caratteri jolly dell'oggetto completamente qualificati al posto di qualsiasi parte del nome dell'oggetto. Per ulteriori informazioni, vedere Utilizzo di caratteri jolly nei nomi degli oggetti di database.
    • Rimuovi: rimuove le regole di mapping.

Abilita log pipeline

  1. Nella pagina Pipeline selezionare la pipeline per la quale si desidera abilitare il log.
  2. Nella pagina Dettagli pipeline, selezionare Log.
  3. Nella lista dei log della pipeline, selezionare Abilita log dal menu Azioni degli eventi critici.
  4. Nel pannello Abilita log:
    1. Per Nome log, immettere un nome.
    2. Dall'elenco a discesa Compartimento selezionare un compartimento.
    3. Per Gruppo di log, è possibile effettuare le operazioni riportate di seguito.
      • Selezionare un gruppo dall'elenco a discesa
      • Creare un nuovo gruppo
      • Lasciare vuoto e viene assegnato automaticamente un gruppo predefinito
    4. Per Conservazione log, selezionare il numero di mesi dall'elenco a discesa.
    5. Fare clic su Abilita log.
Attendere che lo stato diventi Attivo.

Avvia pipeline

Per avviare la pipeline:
  1. Dal menu Azioni nella pagina dei dettagli della pipeline, selezionare Avvia.
  2. Nella pagina dei dettagli della pipeline, selezionare Inizializzazione.

    I passi di inizializzazione visualizzano lo stato corrente dei passi della pipeline. Per ogni passo, è possibile selezionare Visualizza dettagli dal relativo menu Azioni e rivedere i messaggi corrispondenti.

  3. Dopo che lo stato della pipeline è Attivo (in esecuzione), selezionare Esegui.

    I processi runtime visualizzano lo stato e la latenza dei processi di acquisizione e applicazione.

Problemi noti

ZeroETL Errore del processo di applicazione della pipeline di mirroring

Se il processo di applicazione della pipeline non riesce con il seguente errore in OCI Logging:
Error mapping from ADMIN.DBTOOLS$EXECUTION_HISTORY to <ADB ID>.ADMIN.DBTOOLS$EXECUTION_HISTORY.

Soluzione: creare una regola di esclusione con ADMIN.*, quindi riavviare la pipeline.

Oracle Data Pump non riesce se la versione del file del fuso orario del database di destinazione è precedente a quella del database di origine

L'opzione della pipeline "Copia dati esistenti nel database di destinazione prima di avviare la replica" utilizza Oracle Data Pump. Oracle Data Pump non riesce se la versione del file del fuso orario del database di destinazione è precedente a quella del database di origine.

Soluzione: per ovviare a questa situazione, è necessario aggiornare la versione del fuso orario del database di destinazione. Vedere Gestire gli aggiornamenti dei file dei fusi orari su Autonomous Database.