Aggiungi un'estrazione

Informazioni sui prerequisiti e le considerazioni per l'aggiunta di un'estrazione.

Prima di iniziare ad aggiungere un'estrazione, assicurarsi che siano configurate le seguenti impostazioni:

Ora si è pronti per aggiungere un'estrazione per la distribuzione.

Considerazioni per la creazione di un'estrazione quando esistono file trail di estrazione precedenti

Schermata Informazioni estrazione

Dopo aver eseguito il login alla home page dei microservizi, fare clic sul segno + nella colonna Crea per aprire la procedura guidata Aggiungi estrazioni.

Nella schermata Estrai informazioni, selezionare il tipo di estrazione. A seconda della piattaforma di database, i tipi di estrazioni disponibili possono essere Estrazione integrata, Estrazione acquisizione dati modifica e Estrazione caricamento iniziale.

Se è necessario impostare l'estrazione a valle per Oracle AI Database, abilitare lo switch di attivazione/disattivazione Estrazione a valle.

Selezionare il tipo di Extract da creare e specificare quanto segue:

Fare clic su Avanti.

Schermata Registra estrazione - Database PostgreSQL e Yugabyte

Nota: è necessario registrare Oracle GoldenGate Extract for Oracle, diverse versioni PostgreSQL e il database Yugabyte. Tuttavia, le opzioni di configurazione per la registrazione dell'estrazione vengono visualizzate in schermate diverse durante l'aggiunta dell'estrazione.

Nota: vedere anche Linee guida e limitazioni per il tipo di plugin PGOUTPUT.

Nella schermata Registra estrazione configurare le opzioni riportate di seguito e fare clic su Registra.

Fare clic su Avanti dopo che la registrazione Extract è riuscita.

Viene visualizzato un messaggio che indica che la registrazione dell'estrazione è riuscita.

Fare clic su Avanti.

Registra estrazione per database PostgreSQL e Yugabyte dal client di amministrazione

Un Extract per PostgreSQL deve essere registrato con il database ed essere concesso uno slot di replica riservato. Gli slot di replica vengono allocati tramite l'impostazione di configurazione del database max_replication_slots e possono essere configurati come descritto in Configurazione del database.

Segui queste istruzioni per registrare un'estrazione. La registrazione estrazione deve essere eseguita prima di creare un'estrazione. Per ulteriori informazioni, vedere REGISTER EXTRACT nel documento Command Line Interface Reference for Oracle GoldenGate.

  1. Connettersi alla distribuzione, quindi connettersi all'alias delle credenziali per il database di origine.

    CONNECT http*s*://*remotehost*:*srvmgrport* DEPLOYMENT

          *deployment_name* AS *deployment_user* PASSWORD *deployment_password*
    OGG (https://*remotehost*:*16000**postgresql_source*)> DBLOGIN USERIDALIAS *alias*

  2. Registrare l'estrazione, che crea internamente uno slot di replica per l'estrazione. I nomi di estrazione non possono contenere più di 8 caratteri alfanumerici.

    REGISTER EXTRACT *extname*

    Per registrare in modo esplicito Extract con il plugin pgoutput, è necessario specificare il tipo di plugin pgoutput:

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

È inoltre possibile registrare un'estrazione dall'interfaccia Web MA di Oracle GoldenGate. Vedere Aggiungere un'estrazione.

Linee guida e limiti per il tipo di plugin PGOUTPUT

Linee guida per la configurazione del tipo di plugin PGOUTPUT

Seguire queste linee guida durante l'impostazione del tipo di plugin per PostgreSQL:

Limitazioni

Durante la selezione di un tipo di plugin per PostgreSQL si applicano le seguenti limitazioni:

Schermata Opzioni estrazione

Nota: in questa schermata sono disponibili le opzioni per registrare l'estrazione per Oracle AI Database. Se si aggiunge un'estrazione per PostgreSQL, la registrazione dell'estrazione viene completata nella schermata Registra estrazione.

Nella schermata Opzioni estrazione configurare le impostazioni riportate di seguito.

Registra estrazione per Oracle dal client di amministrazione

Segui queste istruzioni per registrare un'estrazione. La registrazione estrazione deve essere eseguita prima di creare un'estrazione.

Assicurarsi di essere connessi al database utilizzando il comando DBLOGIN.

Per ulteriori informazioni, vedere [REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3) nel documento Command Line Interface Reference for Oracle GoldenGate.

  1. Utilizzando il client di amministrazione, connettersi alla distribuzione, quindi connettersi all'alias delle credenziali per il database di origine.

    OGG> CONNECT https://*remotehost*:*srvmgrport* DEPLOYMENT *deployment_name* AS *deployment_user* PASSWORD *deployment_password*

    Quando si esegue il comando CONNECT, il prompt dei comandi passa da "not connected" a "https://servername:port deployment_name", come mostrato nell'esempio seguente:

    OGG (https://*pdbeast.vcn.oracle.com*:*16000**depl_east*)>

  2. Connettersi al database utilizzando il comando DBLOGIN:

    OGG (https://*remotehost*:*port**oracle_source*)> DBLOGIN USERIDALIAS *alias*

  3. Registrare l'estrazione. I nomi di estrazione non possono contenere più di 8 caratteri alfanumerici.

    OGG (https://*remotehost*:*port**oracle_source*)> REGISTER EXTRACT *extname* DATABASE

È inoltre possibile registrare un'estrazione in background durante la creazione di un'estrazione dall'interfaccia Web MA di Oracle GoldenGate. Per informazioni dettagliate, vedere Aggiungere un'estrazione.

Schermata di acquisizione a valle

Valido solo per Oracle.

Se è stata selezionata l'opzione Acquisizione a valle nella schermata Estrai informazioni, viene visualizzata la schermata delle opzioni Acquisizione a valle. Configurare la connessione al database di mining a valle per Extract a valle utilizzando questa schermata.

Nota: l'acquisizione a valle con ADG non supporta l'estrazione per PDB.

Fare clic su Avanti.

Schermata Opzioni gestite

Nella schermata Opzioni gestite configurare le opzioni di avvio automatico e riavvio automatico per il processo Extract. Nella tabella seguente sono disponibili le opzioni elencate di seguito.

Nella tabella seguente sono disponibili le opzioni elencate di seguito.

Opzione Descrizione
Nome profilo

Fornisce il nome del profilo di avvio automatico e riavvio automatico. È possibile selezionare le opzioni predefinite o personalizzate.

Se è già stato creato un profilo, è possibile selezionarlo anche. Se si seleziona l'opzione Personalizzato, è possibile impostare un nuovo profilo da questa sezione stessa.
Critico per lo stato di distribuzione

(solo Oracle) Abilitare questa opzione se il profilo è critico per lo stato della distribuzione.

Nota:

Questa opzione viene visualizzata solo durante la creazione di Extract o Replicat e non quando si impostano i processi gestiti nella pagina Profili.

Avvio automatico Abilita l'avvio automatico per il processo.
Ritardo avvio Periodo di tempo di attesa, in secondi, prima dell'avvio del processo
Riavvio automatico Configura la modalità di riavvio del processo se termina
Numero massimo nuovi tentativi Specificare il numero massimo di tentativi per provare ad avviare il processo
Ritardo nuovo tentativo Ritardo nel tentativo di avviare il processo
Finestra nuovi tentativi Intervallo di durata per provare ad avviare il processo
Riavvia solo in caso di errore Se il valore è true il task viene riavviato solo se non riesce.
Disabilita task dopo nuovi tentativi esauriti Se true, l'attività viene disabilitata dopo aver esaurito tutti i tentativi di riavviare il processo.

Fare clic su Avanti.

Schermata Estrai file parametri

Nella schermata File parametri è possibile modificare il file dei parametri nell'area di testo per elencare i dettagli della tabella che si desidera acquisire. Di seguito è riportato un esempio di file dei parametri Extract.

EXTRACT exte
USERIDALIAS ggeast DOMAIN OracleGoldenGate
EXTTRAIL east/ea
DDL INCLUDE MAPPED
TABLE hr.*;

Fare clic su Crea ed esegui per creare e avviare l'estrazione. Se si seleziona Crea, l'estrazione viene creata, ma è necessario avviarla utilizzando le opzioni di estrazione.

Si torna alla home page del servizio di amministrazione o alla pagina di estrazione in cui sono elencate tutte le estrazioni create.

Crea un file dei parametri per l'estrazione

Per creare un file di parametri per un'estrazione, attenersi alle istruzioni fornite di seguito.

  1. (solo MySQL) Quando si esegue Oracle GoldenGate per MySQL su un server Windows e su un server Linux (per la versione OGG precedente alla 23.10.x) che si trova su un host remoto da il database server, assicurarsi che i relativi fusi orari siano uguali e, in caso contrario, utilizzare il parametro SETENV(TZ) all'interno di Extract e impostarlo sul fuso orario del database server.

    Per ulteriori informazioni sul formato TZ, vedere il parametro SETENV nel manuale Parameters and Functions Reference Guide.

    Per riferimento, vedere i seguenti link:

    https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tzset?view=msvc-170#remarks

    https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html

  2. Sul sistema di origine, eseguire il comando seguente:

    EDIT PARAMS extract_name

    Dove:

    extract_name è il nome dell'estrazione creata con il comando ADD EXTRACT oppure il nome completamente qualificato del file dei parametri se è stata definita una posizione alternativa al momento della creazione del gruppo.

  3. Inserire i parametri nell'ordine mostrato nella tabella seguente, iniziando una nuova riga per ogni istruzione di parametro. Alcuni parametri si applicano solo a determinate configurazioni.

    Parametro Descrizione
    EXTRACT group
    • group è il nome del gruppo Extract creato con il comando ADD EXTRACT.
    		Configura Extract come processo in linea con i checkpoint.
    [, USERIDALIAS alias options ] Vedere [USERIDALIAS](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GWURF-GUID-530D7773-B66D-4499-A509-EF5BB9CE9B05) per specificare le credenziali del database.
    ENCRYPTTRAIL algorithm Cifra tutti gli trail specificati dopo questa voce.
    SOURCECATALOG Specifica un contenitore predefinito in un container database multi-tenant Oracle o in istruzioni SEQUENCE. Consente l'uso di nomi in due parti (schema.object) in cui altrimenti sarebbero richiesti nomi in tre parti per tali database. È possibile utilizzare più istanze di questo parametro per specificare contenitori o cataloghi predefiniti diversi per set diversi di parametri TABLE o SEQUENCE.
    TABLE [container. \| catalog.]owner.object \| schema.object \| library/file \| library/file(member);

    Specifica il nome completamente qualificato di un oggetto o una specifica con caratteri jolly completamente qualificati per più oggetti. Se il database è un container database multi-tenant Oracle, il nome dell'oggetto deve includere il nome del contenitore o del catalogo a meno che non venga utilizzato SOURCECATALOG.

    • schema è il nome dello schema o un set di schemi con caratteri jolly.

    • object è il nome della tabella o un set di tabelle con caratteri jolly.

    • library è il nome della libreria IBM i o un set di librerie con caratteri jolly.

    • file è il nome del file fisico IBM i o un set di file fisici con caratteri jolly.

    • member è il nome del membro del file fisico IBM i o un set con caratteri jolly di nomi membro. Quando si utilizza il formato di nome nativo IBM i (libreria/file con membro facoltativo), gli unici caratteri jolly validi sono un nome con almeno un carattere valido seguito da un asterisco finale (*) o *ALL che corrisponde a qualsiasi nome.

    Nota:

    Il nome del membro è facoltativo e deve essere fornito se i nomi dei membri devono essere scritti nel trail come parte del nome dell'oggetto. Senza i nomi dei membri, tutti i membri di un file fisico vengono implicitamente uniti come un singolo oggetto nel trail.

    Per informazioni sulla specifica dei nomi oggetto nei file dei parametri, vedere Specifica dei nomi oggetto nell'input di Oracle GoldenGate.

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    		 Parametri che possono essere utilizzati insieme per escludere oggetti specifici da una specifica jolly nell'istruzione TABLE associata.

  4. Immettere i parametri di estrazione facoltativi appropriati elencati nei parametri di Oracle GoldenGate.

  5. Salvare e chiudere il file dei parametri.

Il file dei parametri Extract di esempio riportato di seguito spiega vari parametri e opzioni di configurazione per Extract:

ADD EXTRACT *extract_name*
{, datasource}
{, BEGIN start_point} | {position_point}
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']

Opzioni parametro aggiuntive per estrazione

Informazioni sui parametri aggiuntivi che potrebbero essere necessari per la configurazione Extract.

Extract utilizza un server di logmining del database nel database di mining per estrarre il flusso di redo del database di origine. È possibile impostare parametri specifici del server di logmining utilizzando il parametro TRANLOGOPTIONS con l'opzione INTEGRATEDPARAMS nel file dei parametri Extract.

Nota: per informazioni dettagliate e istruzioni sull'uso per questi parametri, vedere la sezione "DBMS_CAPTURE_ADM" in Oracle AI Database PL/SQL Packages and Types Reference.

I seguenti parametri possono essere impostati con INTEGRATEDPARAMS:

Vedere Gestione delle risorse del server.