Crea risorse pipeline

Informazioni per creare le risorse necessarie per utilizzare le pipeline.

Crea connessioni

Le pipeline GoldenGate OCI supportano le connessioni a Oracle AI Database. Prima di creare una pipeline, assicurarsi di preparare il database per GoldenGate, quindi di creare connessioni ai database di origine e di destinazione.

Nota: se si esegue la replica da un'origine di Autonomous AI Database a una destinazione che non è un Autonomous AI Database, è necessario decomprimere il wallet di Autonomous AI Database di origine in /u01/targetwallet nel database di destinazione. DBLINK viene creato dal database di destinazione al database di origine.

È inoltre possibile creare connessioni di origine connessione e di destinazione nel workflow Crea pipeline.

Creare pipeline

Prima di iniziare:

Assicurarsi di effettuare quanto riportato di seguito.

Controllare le versioni del database di origine e di destinazione. La versione del database di destinazione deve essere uguale o successiva a quella del database di origine.
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 target.
In qualità di utente con privilegi di amministratore per il database di destinazione, concedere all'utente GGADMIN i seguenti privilegi 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;
```
Inoltre, per i database AI non autonomi, aggiungere quanto riportato di seguito per il caricamento iniziale.
```
GRANT DATAPUMP_EXP_FULL_DATABASE TO GGADMIN CONTAINER=CURRENT;
GRANT DATAPUMP_IMP_FULL_DATABASE TO GGADMIN CONTAINER=CURRENT;
GRANT CREATE DATABASE LINK TO GGADMIN CONTAINER=CURRENT;
```
Per acquisire e applicare nei database AI non autonomi, consulta Preparare gli utenti e i privilegi del database per Oracle.
Controllare la vista DBA_GOLDENGATE_SUPPORT_MODE nel database di origine che visualizza informazioni sul livello di supporto del processo di acquisizione di Oracle GoldenGate per le tabelle nel database.
Aggiungere i criteri minimi richiesti per le pipeline GoldenGate.

Nota:

Se replichi i dati da Autonomous AI Database a un database AI non autonomo, devi disattivare GLOBAL_NAMES nel tuo database AI non autonomo. Eseguire il comando riportato di seguito:

ALTER SYSTEM SET GLOBAL_NAMES = FALSE;

Per ulteriori informazioni, vedere il passo 4 di Creare database link da altri database a Autonomous AI Database.

Per creare una pipeline, procedere come segue.

Nella pagina Panoramica di GoldenGate OCI, nel menu GoldenGate, selezionare Pipeline.

In alternativa, è possibile selezionare Data Fabric, quindi Crea pipeline.
Nella pagina Pipeline selezionare Crea pipeline.
Nel pannello Crea pipeline, completare i campi come indicato di seguito, quindi selezionare Crea pipeline.
1. In Nome, immettere un nome per la pipeline.
2. (Facoltativo) In Descrizione, immettere una descrizione per facilitare la distinzione tra questa pipeline e altre.
3. In 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:
  - Se non sono state ancora create connessioni, selezionare Crea connessione per iniziare.
  - Se si utilizza una connessione con un endpoint condiviso come origine o destinazione, è necessario selezionare anche una subnet.
6. (Facoltativo) Espandere Opzioni avanzate per configurare le opzioni di 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 e quindi carica le righe dall'origine.
    - Sostituisci: elimina la tabella esistente, quindi crea e carica dall'origine.
    - Aggiungi: lascia invariate le righe esistenti e carica le righe dall'origine.
    - Ignora: lascia la tabella così com'è e passa all'oggetto successivo.
  - Tipo di caricamento iniziale: selezionare il metodo per trasferire un data set completo dall'origine alla destinazione prima di avviare la replica in corso.
    - Database Link: trasferisce i dati direttamente dal database di origine al database di destinazione utilizzando un database link stabilito, senza storage intermedio. Funziona meglio per database situati nella stessa rete o connessi tramite un collegamento stabile e ad alta velocità.
    - Storage degli oggetti: posiziona i dati di caricamento iniziale nello storage degli oggetti Oracle prima di importarli nel database di destinazione. Funziona meglio per le migrazioni che coinvolgono grandi volumi di dati in aree o ambienti diversi.
      
      Ulteriori informazioni sui tipi di caricamento iniziale.
  - Sostituisci modifiche allo schema (DDL): se selezionata, scegliere l'azione da eseguire sugli schemi esistenti quando il processo rileva un errore:
    - Termina: esegue il rollback della transazione e interrompe l'elaborazione.
    - Ignora: registra l'errore nel file eliminato 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:
    - Termina
    - Elimina
    - Ignora
  - Riavvia dopo errore: selezionare questa opzione per abilitare il riavvio automatico nel caso in cui il processo venga interrotto per qualsiasi motivo.
  - Avvia pipeline utilizzando il mapping predefinito: avvia la pipeline immediatamente dopo la creazione con le regole di mapping 1:1 predefinite. Se non è selezionata, è possibile configurare i mapping delle regole dopo la creazione e quindi avviare manualmente la pipeline.

Aggiungi regole di mapping

Per visualizzare in anteprima, aggiungere o rimuovere le regole di mapping, procedere come segue.

Nella pagina delle informazioni sulla pipeline selezionare Regole di mapping.
Nell'elenco delle regole di mapping è possibile rivedere o modificare le regole di mapping correnti e:
- Anteprima: esaminare in che modo le regole di mapping influiscono sugli schemi e sulle tabelle inclusi nella replica.
- Aggiungi: consente di identificare tabelle e schemi da includere o escludere. È possibile utilizzare il nome oggetto completamente qualificato o i caratteri jolly al posto di qualsiasi parte del nome oggetto. Per ulteriori informazioni, vedere Uso di caratteri jolly nei nomi degli oggetti di database.
- Rimuovi: rimuove le regole di mapping.

Abilita log pipeline

Nella pagina Pipeline selezionare la pipeline per la quale si desidera abilitare il log.
Nella pagina Dettagli pipeline, selezionare Log.
Nella lista dei log della pipeline, selezionare Abilita log dal menu Azioni Eventi critici.
Nel pannello Abilita log:
1. Per Nome log, immettere un nome.
2. Nell'elenco a discesa Compartimento selezionare un compartimento.
3. Per il gruppo di log è possibile:
  - Selezionare un gruppo dall'elenco a discesa
  - Creare un nuovo gruppo
  - Lasciarlo vuoto e viene assegnato automaticamente un gruppo predefinito
4. Per Conservazione log, selezionare il numero di mesi dall'elenco a discesa.
5. Selezionare Abilita log

Attendere che lo stato diventi Attivo.

Avvia pipeline

Per avviare la pipeline:

Nel menu Azioni della pagina dei dettagli della pipeline, selezionare Avvia.
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 ed esaminare i messaggi corrispondenti.
Dopo che lo stato della pipeline è Attivo (In esecuzione), selezionare Runtime.

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

Problemi noti

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 risolvere questo problema, è necessario aggiornare la versione del fuso orario del database di destinazione. Vedere Gestire gli aggiornamenti dei file del fuso orario su Autonomous AI Database.