Replicare i dati da Autonomous Transaction Processing a OCI Object Storage

Prima di iniziare

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

Una chiave API creata e scaricata dalla pagina dei dettagli utente
Un'istanza di Autonomous Transaction Processing di origine
OCID compartimento

Impostazione dell'ambiente: Autonomous Transaction Processing

Se non si dispone già di un database di origine impostato per la replica, è possibile attenersi alla procedura riportata di seguito per caricare uno schema di esempio da utilizzare per questo avvio rapido. Questa istanza rapida utilizza Autonomous Transaction Processing per il database di origine.

Per impostare l'Autonomous Database di origine, effettuare le operazioni riportate di seguito.

Scaricare ed estrarre lo schema di database di esempio.
Nella console di Oracle Cloud, selezionare l'istanza ATP (Autonomous Transaction Processing) dalla pagina Autonomous Database per visualizzarne i dettagli e accedere a Database Actions.
Sbloccare l'utente GGADMIN:
1. Fare clic su Azioni di database, quindi fare clic su Utenti di database.
2. Individuare GGADMIN, quindi fare clic sul relativo menu con i puntini (tre punti) e selezionare Modifica.
3. Nel pannello Modifica utente, immettere la password GGADMIN, confermare la password, quindi deselezionare L'account è bloccato.
4. Fare clic su Applica modifiche.
Caricare lo schema e i dati di esempio di origine:
1. Nel menu Database Actions, in Sviluppo, selezionare SQL.
2. Copiare e incollare lo script da OCIGGLL_OCIGGS_SETUP_USERS_ATP.sql nel foglio di lavoro SQL.
3. Fare clic su Esegui script. La scheda Output script visualizza 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.
Abilita il log supplementare:
1. Cancellare il foglio di lavoro SQL.
2. Immettere la seguente istruzione, quindi fare clic su 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.

Creare una distribuzione Oracle per l'istanza di Autonomous Transaction Processing di origine.
Creare una distribuzione Big Data per il bucket di storage degli oggetti OCI di destinazione.
Creare una connessione per l'istanza di Autonomous Transaction Processing di origine.
Creare la connessione per lo storage degli oggetti OCI di destinazione.
Creare una connessione a GoldenGate, quindi assegnare questa connessione alla distribuzione Oracle di origine.
Assegnare la connessione Autonomous Transaction Processing all'implementazione Oracle di origine.
Assegnare la connessione allo storage degli oggetti OCI alla distribuzione di Big Data di destinazione.

Task 2: aggiungere Extract

Nella pagina Distribuzioni selezionare la distribuzione di Autonomous Transaction Processing di origine.
Nella pagina dei dettagli della distribuzione, fare clic su Avvia console.
Eseguire il login con il nome utente e la password dell'amministratore della distribuzione di origine.
Aggiungi informazioni sulla transazione.
Aggiungere un Extract.

Task 3: aggiungere ed eseguire Distribution Path

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.
Nella console di distribuzione ATP origine GoldenGate, aggiungere una connessione percorso per l'utente creato nel passo 1.
1. Nella console di distribuzione ATP di origine GoldenGate, fare clic su Connessioni percorso nella navigazione a sinistra.
2. Fare clic su Aggiungi connessione percorso (icona più), quindi completare le operazioni riportate di seguito.
  1. In 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 verifica.
3. Fare clic su Sottometti.
  
  La connessione percorso viene visualizzata nella lista Connessioni percorso.
Nella console di distribuzione ATP origine, aggiungere un percorso di distribuzione con i valori riportati di seguito.
1. Nella pagina Opzioni di origine:
  - In Estrazione origine selezionare l'estrazione creata nel task 2.
  - In Nome traccia, immettere un nome di due caratteri, ad esempio E1.
2. Nella pagina Opzioni di destinazione:
  - Per Host di destinazione, immettere il dominio host della distribuzione di destinazione.
  - In Numero porta, immettere 443.
  - In Nome traccia, immettere un nome di due caratteri, ad esempio E1.
  - Per Alias, immettere l'alias di credenziale creato nel passo 2.
Nella console di distribuzione dei Big Data destinazione, esaminare il file Receiver Path creato come risultato del file Distribution Path.
1. Nella console di distribuzione dei Big Data di destinazione, fare clic su Receiver Service.
2. Esaminare i dettagli del percorso. Questo percorso è stato creato come risultato della creazione di Distribution Path nel passo precedente.

Task 4: aggiungere ed eseguire Replicat

Nel menu di navigazione della console di distribuzione Big Data destinazione, fare clic su Replicats.
Nella pagina Replicats, fare clic su Aggiungi Replicat (icona più), quindi completare il modulo come indicato di seguito.
1. Nella pagina Informazioni Replicat:
  1. Per Replicat Tipo, selezionare Classico Replicat.
  2. Per Nome processo, immettere un nome, ad esempio REP
2. Nella pagina Opzioni Replicat:
  1. Per Replicat Nome trail, immettere un nome di due caratteri, ad esempio E1.
  2. Per Destinazione, selezionare Storage degli oggetti OCI
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 storage degli oggetti OCI.
  - 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 la modalità di formattazione dell'output. json_row è l'impostazione predefinita. Le opzioni disponibili includono:
    
    testo delimitato
    
    json
    
    json_row
    
    xml
    
    avro_row_ocf
    
    avro_op_ocf
    
    Suggerimento
    Per utilizzare la proprietà di formattazione per OCI Object Storage, 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 OCI. Per impostazione predefinita, è impostato su 5 secondi. È possibile specificare un'ora 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à. Una volta raggiunta la dimensione, 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 nello stesso file al riavvio di Replicat. Ad esempio, gg.handler.oci.rollOnShutdown=false
  - gg.handler.oci.fileRollInterval: indica il periodo di tempo in cui il file deve essere aperto prima che venga chiuso e viene trasferito in un nuovo file. Per impostazione predefinita è impostato su 7 minuti. È possibile specificare un'ora 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 dello storage degli oggetti.
5. Fare clic su Crea ed esegui.

Task 5: verificare la replica

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

Nella console di Oracle Cloud, aprire il menu di navigazione, selezionare Oracle Database, quindi selezionare Autonomous Transaction Processing.
Nella lista delle istanze di Autonomous Transaction Processing, selezionare l'istanza di origine per visualizzarne i dettagli.
Nella pagina dei dettagli del database, fare clic su Azioni del database.

Nota
Dovresti essere connesso automaticamente. In caso contrario, eseguire il login con le credenziali del database.
Nella home page Database Actions selezionare SQL.

Immettere quanto segue nel foglio di lavoro e fare clic su 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);

Nella console di distribuzione ATP di origine, selezionare il nome Extract, quindi fare clic su Statistiche. Verificare che in SRC_OCIGGLL.SRC_CITY siano presenti 10 inserimenti.
Nella console di distribuzione OCI GoldenGate dei Big Data di destinazione, selezionare il nome Replicat, quindi fare clic su Statistiche. Verificare che in SRC_OCIGGLL.SRC_CITY siano presenti 10 inserimenti.
Nella console di Oracle Cloud, passare al bucket OCI Object Storage e verificarne il contenuto.

Task 6: Monitorare e mantenere i processi

Ulteriori informazioni

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