ADD REPLICAT

Utilizzare ADD REPLICAT per creare un gruppo Replicat. Questo comando crea un gruppo di processi in rete che crea checkpoint in modo che la continuità dell'elaborazione venga conservata da un'esecuzione all'altra. La dimensione di tutte le parole chiave e dell'input non può superare i 500 byte, compreso l'eventuale testo immesso per l'opzione DESC.

Oracle GoldenGate è in grado di supportare fino a 5.000 gruppi Extract e Replicat concorrenti per singola istanza di Oracle GoldenGate Service Manager. Al livello supportato è possibile controllare e visualizzare tutti i gruppi in modalità completa mediante comandi quali INFO e STATUS

Per gestire in modo efficace l'ambiente in uso, è consigliabile mantenere il numero dei gruppi Extract e Replicat, combinati, sul livello predefinito di 300 unità o meno.

(Oracle) A meno che non venga utilizzata l'opzione INTEGRATED, questo comando crea un gruppo Replicat in modalità non integrata.

Sintassi

ADD REPLICAT group_name
[, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
{, EXTTRAIL trail_name}
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, EXTRBA rba]
{, CHECKPOINTTABLE owner.table}
[, DESC 'description']
[, ENCRYPTIONPROFILE encryption-profile-name ]
                [ CRITICAL        [ YES | NO ]  ]
                [ PROFILE          profile-name
[ AUTOSTART
                [ YES | NO ]
                [ DELAY delay-number ] ]
                [ AUTORESTART [ YES | NO ]
                [ RETRIES      retries-number ]
                [ WAITSECONDS  wait-number    ]
                [ RESETSECONDS reset-number   ]
                [ DISABLEONFAILURE [ YES | NO ]     ] ] ]

group_name

Nome del gruppo Replicat. Se non si specifica alcuna opzione, verrà creato un gruppo Replicat classico. Il nome di un gruppo Replicat coordinato e parallelo può contenere al massimo cinque caratteri. Il nome di un gruppo Replicat normale può contenere fino a otto caratteri.

INTEGRATED

(Oracle) Crea il gruppo Replicat in modalità integrata. Senza questa opzione il comando Replicat viene creato da ADD REPLICAT in modalità non integrata (classica). Questa opzione funziona anche con Replicat parallelo. In questa modalità, il processo Replicat sfrutta la funzionalità di applicazione dell'elaborazione disponibile in Oracle AI Database. Quando questa modalità è attiva, Replicat esegue le operazioni riportate di seguito.

L'opzione INTEGRATED deve essere utilizzata per un Replicat di sincronizzazione della modifica in modalità online che esegue le operazioni di lettura dal trail locale specificato daEXTTRAIL.

Sia Integrated Replicat che Replicat parallelo in modalità integrata gestiscono la tabella di checkpoint, se esistente. Vedere anche ADD CHECKPOINTTABLE.

Integrated Replicat o Replicat parallelo non gestisce TRACETABLE in modalità integrata.

Quando la modalità integrata è attiva, Replicat non supporta i parametri seguenti:

PARALLEL

Valido per tutti i database supportati.

Aggiunge il gruppo Replicat in modalità parallela. In questa modalità Replicat applica le transazioni in parallelo per migliorare le prestazioni. Inoltre, tiene conto delle dipendenze tra le transazioni. PARALLEL INTEGRATED Replicat è valido solo per Oracle. Aggiunge il Replicat parallelo in modalità integrata, che come Integrated Replicat sfrutta la funzionalità di elaborazione dell'applicazione disponibile in Oracle AI Database.

Nota: durante la configurazione di Replicat parallelo per Sybase, assicurarsi di eseguire l'aggiornamento alla versione 16.0 SP3 PL15 e successive per impedire che il servizio di amministrazione si disconnetta in modo intermittente.

COORDINATED [MAXTHREADS number]

Crea il gruppo Replicat in modalità coordinata. Un gruppo Replicat coordinato utilizza più thread per consentire l'elaborazione parallela. Questa opzione aggiunge il coordinatore (identificato dal nome del gruppo) e il numero massimo di thread di elaborazione specificati per impostazione predefinita o con MAXTHREADS. Le dipendenze vengano calcolate e coordinate dal coordinatore, mentre l'elaborazione SQL viene eseguita dai thread.

Per creare un Replicat COORDINATED è necessaria una tabella di checkpoint.

L'opzione COORDINATED deve essere utilizzata per un Replicat di sincronizzazione della modifica in modalità online che esegue le operazioni di lettura dal trail locale specificato daEXTTRAIL. Nota: il nome di un gruppo Replicat coordinato può contenere solo cinque caratteri.

MAXTHREADS number

Specifica il numero massimo di thread di elaborazione che il gruppo Replicat può generare dinamicamente. Questi thread vengono creati tutti all'avvio, ma a seconda degli elementi specificati nelle istruzioni MAP nel file dei criteri, alcuni dei quali o tutti elaboreranno il carico di lavoro in qualsiasi momento. Come regola generale, specificare due volte il numero di thread specificati nelle istruzioni MAP quando si esegue la ripartizione del carico di lavoro. Ciò consente di aggiungere altri thread in caso di aumento del carico di lavoro, senza dover eliminare e creare di nuovi il gruppo Replicat. Per ulteriori informazioni sulla ripartizione del carico di lavoro tra i thread, vedere TABLE \| MAP.

Se si omette MAXTHREADS, il numero predefinito di thread è 25. Il numero massimo di thread è 500.

MAXTHREADS è correlato al parametro MAXGROUPS. MAXGROUPS controlla il numero massimo di gruppi di processo (Extract e Replicat) consentito per ogni istanza di Oracle GoldenGate. Ogni thread Replicat viene considerato come gruppo Replicat nel contesto di MAXGROUPS. Pertanto il numero di gruppi Extract e Replicat nell'istanza Oracle GoldenGate, sommato al valore di MAXTHREADS, non può superare il valore di MAXGROUPS. Vedere MAXGROUPS.

EXTTRAIL trail_name

Specifica il nome relativo o completamente qualificato di un trail creato con il comando ADD EXTTRAIL.

BEGIN {NOW yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z}

Definisce un checkpoint iniziale nel trail.

NOW

Inizia a replicare le modifiche a partire dall'ora di creazione del gruppo.

yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z

Inizia a estrarre le modifiche a partire da una data e un'ora specifiche.

EXTRBA extrba

Valido per Db2 z/OS.

Specifica l'indirizzo byte relativo all'interno del file di trail specificato da EXTSEQNO. Contattare il Supporto Oracle prima di utilizzare questa opzione.

CHECKPOINTTABLE {owner.table NODBCHECKPOINT}

Non valido per l'adattatore Oracle GoldenGate Applications o Oracle GoldenGate per Big Data.

NODBCHECKPOINT non è valido per Oracle AI Database di destinazione. Oracle consiglia di utilizzare una tabella di checkpoint. Il gruppo Replicat parallelo e coordinato in modalità integrata e non integrata richiede una tabella di checkpoint.

Specifica che il gruppo Replicat scriverà i checkpoint nella tabella specificata nel database. Includere il nome del proprietario e la tabella, come in ggadmin.ggs_checkpoint. Questo argomento sostituisce la specifica CHECKPOINTTABLE predefinita nel file GLOBALS. La tabella deve essere dapprima aggiunta con il comando ADD CHECKPOINTTABLE.

Per i database di destinazione non di Oracle, quando si specifica NODBCHECKPOINT, il gruppo Replicat non scrive i checkpoint in una tabella dei checkpoint. Questo argomento sostituisce la specifica CHECKPOINTTABLE predefinita nel file GLOBALS. L'argomento è obbligatorio se non si desidera utilizzare una tabella di checkpoint con il gruppo Replicat in fase di creazione.

Per la destinazione Oracle AI Database, Oracle GoldenGate 26ai e versioni successive non supporterà il parametro NODBCHECKPOINT durante l'aggiunta di un Replicat. Dopo l'upgrade a Oracle GoldenGate 26ai, se Replicat esistente per Oracle AI Database è stato creato con NODBCHECKPOINT e non è stato specificato alcun checkpoint di database predefinito in GLOBALS, Replicat viene interrotto all'avvio. Per evitare questa situazione, è necessario eseguire uno dei task riportati di seguito.

Opzione 1: Oracle consiglia di specificare una tabella di checkpoint del database predefinita in GLOBALS

oppure

Opzione 2: creare un nuovo Replicat specificando la tabella di checkpoint ed eseguire il riavvio dall'SCN che sostituisce il Replicat di cui è stato eseguito l'upgrade.

DESC ‘description’

Specifica una descrizione del gruppo, ad esempio 'Loads account_tab on Serv2'. Includere la descrizione tra apici.

ENCRYPTIONPROFILE

Specifica il nome del profilo di cifratura per Replicat.

CRITICAL

Indica se il processo è di importanza critica per la distribuzione.

PROFILE

Nome del profilo di avvio automatico.

AUTOSTART

Specifica se il processo gestito deve essere avviato in modo automatico all'avvio del servizio di amministrazione. Il valore predefinito è YES.

DELAY

Periodo di tempo di attesa, in secondi, prima dell'avvio del processo.

AUTORESTART

Controlla le modalità di riavvio del processo se terminato.

RETRIES

Numero massimo di tentativi per il riavvio del task prima di annullare gli sforzi di nuovi tentativi. Questa opzione è facoltativa.

WAITSECONDS

Il periodo di tempo, in secondi, durante il quale vengono contati i nuovi tentativi.

RESETSECONDS

Reimposta il periodo di tempo durante il quale vengono contati i nuovi tentativi.

DISABLEONFAILURE

Quando l'impostazione è TRUE, il task viene disabilitato all'esaurimento del numero dei nuovi tentativi consentiti.

Esempi

Nell'esempio seguente viene aggiunto il gruppo Integrated Replicat denominato reps. Per la visualizzazione dell'output viene utilizzato il comando INFO.

ADD REPLICAT reps, INTEGRATED, EXTTRAIL ea, checkpointtable ggadmin.ckpt1

Viene visualizzato il seguente output:

2019-11-21T20:01:10Z  INFO    OGG-08100  REPLICAT (Integrated) added.

Di seguito viene fornito un esempio di aggiunta del Replicat parallelo denominato repw.

ADD REPLICAT repw, INTEGRATED, PARALLEL, EXTTRAIL ea, checkpointtable ggadmin.ggs_checkpoint

Viene visualizzato il seguente output:

2019-11-21T20:07:26Z  INFO    OGG-08100  REPLICAT (Parallel) added.