Replica i dati da Autonomous AI Transaction Processing allo storage degli oggetti Oracle

Questo esempio di avvio rapido descrive come replicare i dati da Autonomous AI Transaction Processing allo storage degli oggetti Oracle utilizzando OCI GoldenGate.

Questo Quickstart è disponibile anche come workshop LiveLab. Guarda il workshop

Prima di iniziare

Per completare correttamente questo avvio rapido, è necessario disporre dei seguenti elementi:

• Chiave API creata e scaricata dalla pagina dei dettagli utente della console di Oracle Cloud

• Un'istanza di elaborazione delle transazioni AI autonoma di origine

• OCID compartimento

Impostazione dell'ambiente: Autonomous AI Transaction Processing

Se non si dispone già di un database di origine impostato per la replica, è possibile seguire questi passi per caricare uno schema di esempio da utilizzare per questo avvio rapido. Questo Quickstart utilizza Autonomous AI Transaction Processing per il database di origine.

Per impostare l'elaborazione delle transazioni AI autonoma di origine:

1. Scaricare ed estrarre lo schema di database di esempio.

2. Nella console di Oracle Cloud, selezionare l'istanza di Autonomous AI Transaction Processing (ATP) dalla pagina Database AI autonomi per visualizzarne i dettagli e accedere a Database Actions.

3. Sblocca l'utente GGADMIN:

   1. Selezionare Azioni del database, quindi Utenti del database.

   2. Individuare GGADMIN, quindi selezionare il menu con i puntini di sospensione (tre punti) e selezionare Modifica.

   3. Nel pannello Modifica utente immettere la password GGADMIN, confermare la password, quindi deselezionare Account bloccato.

   4. Selezionare Applica modifiche.

4. Caricare lo schema e i dati di esempio di origine:

   1. Nel menu Azioni database, in Sviluppo, selezionare SQL.

   2. Copiare e incollare lo script da OCIGGLL_OCIGGS_SETUP_USERS_ATP.sql nel foglio di lavoro SQL.

   3. Selezionare Esegui script. Nella scheda Output script vengono visualizzati i messaggi di conferma.

   4. Cancellare il foglio di lavoro SQL, quindi copiare e incollare lo script SQL da OCIGGLL_OCIGGS_SRC_USER_SEED_DATA.sql.

      Suggerimento: potrebbe essere necessario eseguire ciascuna istruzione separatamente affinché lo strumento SQL esegua correttamente gli script.

   5. Per verificare che le tabelle siano state create correttamente, chiudere la finestra SQL e riaprirla. Nella scheda Navigator, cercare lo schema SRC_OCIGGLL, quindi selezionare le tabelle dai rispettivi elenchi a discesa.

5. Abilita il log supplementare:

   1. Cancellare il foglio di lavoro SQL.

   2. Immettere l'istruzione seguente, quindi selezionare Esegui istruzione:

      ALTER PLUGGABLE DATABASE ADD SUPPLEMENTAL LOG DATA;

Task 1: creare le risorse OCI GoldenGate

Questo esempio di avvio rapido richiede distribuzioni e connessioni sia per l'origine che per la destinazione.

1. Creare una distribuzione Oracle per l'istanza di Autonomous AI Transaction Processing di origine.

2. Creare una distribuzione di Big Data per il bucket di storage degli oggetti Oracle di destinazione.

3. Creare una connessione per l'istanza di Autonomous AI Transaction Processing di origine.

4. Crea connessione per lo storage degli oggetti Oracle di destinazione.

5. Creare una connessione a GoldenGate, quindi assegnare questa connessione alla distribuzione Oracle di origine.

6. Assegnare la connessione Autonomous AI Transaction Processing alla distribuzione Oracle di origine.

7. Assegnare la connessione allo storage degli oggetti Oracle alla distribuzione dei Big Data di destinazione.

Task 2: Aggiunta dell'estrazione

1. Nella pagina Distribuzioni selezionare la distribuzione Autonomous AI Transaction Processing di origine.

2. Nella pagina dei dettagli della distribuzione selezionare Avvia console.

3. Eseguire il login con nome utente e password dell'amministratore della distribuzione di origine.

4. Aggiungi un'estrazione.

Task 3: Aggiunta ed esecuzione del percorso di distribuzione

1. Se si utilizza l'area di memorizzazione delle credenziali GoldenGate, creare un utente per il percorso di distribuzione nella distribuzione dei Big Data destinazione, altrimenti passare al passo 3.

2. Nella console di distribuzione origine GoldenGate aggiungere una connessione percorso per l'utente creato nel Passo 1.

   1. Nella console di distribuzione GoldenGate di origine, selezionare Connessioni percorso nella navigazione a sinistra.

   2. Selezionare Aggiungi connessione percorso (icona più), quindi completare quanto riportato di seguito.

      1. Per Alias credenziale, immettere GGSNetwork.

      2. In ID utente, immettere il nome dell'utente creato nel Passo 1.

      3. Immettere due volte la password dell'utente per la verifica.

   3. Selezionare Sottometti.

      La connessione al percorso viene visualizzata nell'elenco Connessioni percorso.

3. Nella console di distribuzione origine, aggiungere un percorso di distribuzione con i valori seguenti:

   1. Nella pagina Opzioni di origine effettuare le operazioni riportate di seguito.

      • Per Estrazione origine, selezionare l'estrazione creata nel task 2.

      • In Nome percorso, immettere un nome di due caratteri, ad esempio E1.

   2. Nella pagina Opzioni di destinazione effettuare le operazioni riportate di seguito.

      • Per Host di destinazione, immettere il dominio host della distribuzione di destinazione.

      • In Numero porta, immettere 443.

      • In Nome percorso, immettere un nome di due caratteri, ad esempio E1.

      • In Alias, immettere l'alias credenziale creato nel Passo 2.

4. Nella console di distribuzione Big Data destinazione, esaminare il percorso del ricevente creato come risultato del percorso di distribuzione.

   1. Nella console di distribuzione Big Data di destinazione selezionare Servizio ricevente.

   2. Rivedere i dettagli del percorso. Questo percorso è stato creato come risultato del percorso di distribuzione creato nel passo precedente.

Task 4: Aggiungere ed eseguire Replicat

1. Nel menu di navigazione della console di distribuzione Big Data destinazione, selezionare Replicat.

2. Nella pagina Replicat, selezionare Aggiungi Replicat (icona più) e quindi completare il modulo come indicato di seguito.

   1. Nella pagina Informazioni Replicat:

      1. In Tipo di replica selezionare Replicat classico.

      2. In Nome processo, immettere un nome, ad esempio REP

   2. Nella pagina Opzioni Replicat:

      1. In Nome trail replica immettere un nome di due caratteri, ad esempio E1.

      2. Per Destinazione, selezionare Storage oggetti Oracle

   3. Nella pagina File dei parametri, sostituire MAP *.*, TARGET *.*; con:

      MAP SRC_OCIGGLL.*, TARGET *.*;

   4. Nella pagina File delle proprietà configurare le proprietà dell'handler di eventi OCI in base alle esigenze.

      Proprietà obbligatorie:

      • gg.eventhandler.oci.compartmentID: l'OCID del compartimento in cui risiede il bucket di Oracle Object Storage.

      • gg.handler.oci.fileNameMappingTemplate: genera i nomi dei file in modo dinamico utilizzando Parole chiave modello.

      Le proprietà che è possibile modificare includono:

      • gg.handler.oci.format: selezionare come formattare l'output. json_row è l'impostazione predefinita. Le opzioni disponibili includono:

        • testo delimitato

        • json

        • riga_Json

        • xml

        • avro_row_ocf

        • avro_op_ocf

          Suggerimento: per utilizzare la proprietà di formattazione per lo storage degli oggetti Oracle, sostituire name con oci. Ad esempio, gg.handler.name.format diventa gg.handler.oci.format.

      • gg.handler.oci.inactivityRollInterval: GoldenGate crea un file e lo mantiene aperto per la scrittura. Questa proprietà chiude il file dopo il periodo di inattività designato (nessuna transazione in entrata), quindi lo carica nello storage degli oggetti Oracle. Per impostazione predefinita, è impostato su 5 secondi. È possibile specificare un tempo in millisecondi (ms), secondi (s), minuti (m) o ore (h). Ad esempio, gg.handler.oci.inactivityRollInterval=10m.

      • gg.handler.oci.maxFileSize: File Writer Handler apre il file e lo mantiene aperto fino a raggiungere la dimensione massima del file, supponendo che non ci siano modifiche ai metadati. Per impostazione predefinita, la dimensione massima del file è di 1 GB, ma è possibile modificarla utilizzando questa proprietà. Quando la dimensione viene raggiunta, il file viene chiuso e viene generato un nuovo file. Ad esempio, gg.handler.oci.maxFileSize=500m.

      • gg.handler.oci.rollOnShutdown: il valore predefinito è true. Se impostato su true, GoldenGate chiude il file aperto quando si arresta il processo Replicat. Per impostazione predefinita, File Writer Handler mantiene il file aperto anche se Replicat si arresta e continua a scrivere sullo stesso file al riavvio di Replicat. Ad esempio, gg.handler.oci.rollOnShutdown=false

      • gg.handler.oci.fileRollInterval: indica il periodo di tempo necessario per mantenere il file aperto prima della chiusura e passa a un nuovo file. Per impostazione predefinita, è impostata su 7 minuti. È possibile specificare un tempo in millisecondi (ms), secondi (s), minuti (m) o ore (h). Ad esempio, gg.handler.oci.fileRollInterval=10m.

      • gg.eventhandler.oci.bucketMappingTemplate: immettere il nome del bucket di Oracle Object Storage.

   5. Selezionare Crea ed esegui.

Task 5: Verificare la replica

Eseguire alcuni aggiornamenti all'istanza di Autonomous AI Transaction Processing di origine per verificare la replica nello storage degli oggetti Oracle.

1. Nella console di Oracle Cloud, aprire il menu di navigazione, selezionare Oracle AI Database, quindi selezionare Autonomous AI Transaction Processing.

2. Nell'elenco delle istanze di Autonomous AI Transaction Processing selezionare l'istanza di origine per visualizzarne i dettagli.

3. Nella pagina dei dettagli del database selezionare Azioni del database.

   Nota: il login deve essere eseguito automaticamente. In caso contrario, eseguire il login con le credenziali del database.

4. Nella home page delle azioni del database selezionare SQL.

5. Immettere quanto segue nel foglio di lavoro e selezionare Esegui script.

   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1000,'Houston',20,743113);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1001,'Dallas',20,822416);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1002,'San Francisco',21,157574);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1003,'Los Angeles',21,743878);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1004,'San Diego',21,840689);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1005,'Chicago',23,616472);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1006,'Memphis',23,580075);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1007,'New York City',22,124434);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1008,'Boston',22,275581);
   Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1009,'Washington D.C.',22,688002);

6. Nella console di distribuzione ATP di origine selezionare il nome di estrazione, quindi selezionare Statistiche. Verificare che in SRC_OCIGGLL.SRC_CITY siano presenti 10 inserimenti.

7. Nella console di distribuzione Big Data OCI GoldenGate di destinazione, selezionare il nome Replicat, quindi selezionare Statistiche. Verificare che in SRC_OCIGGLL.SRC_CITY siano presenti 10 inserimenti.

8. Nella console di Oracle Cloud, accedere al bucket di Oracle Object Storage e controllarne il contenuto.

Task 6: Monitoraggio e manutenzione dei processi

1. Monitorare il processo di replica.

2. Gestisci file trail.

Ulteriori informazioni

Ulteriori informazioni sui dettagli di configurazione e sui formati di file supportati.