SEND REPLICAT

Utilizzare SEND REPLICAT per comunicare con un processo Replicat avviato o in esecuzione. La richiesta verrà elaborata non appena Replicat sarà pronto ad accettare i comandi dagli utenti.

Sintassi

SEND REPLICAT group_name[threadID],
{
CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE} |
DEPENDENCYINFO [TXNCOUNT num] |
FORCESTOP |
GETLAG |
GETPARAMINFO [parameter_name] [FILE output_file] |
HANDLECOLLISIONS | NOHANDLECOLLISIONS [table_spec] |
INTEGRATEDPARAMS(parameter_specification) |
LOGEND |
REPORT [HANDLECOLLISIONS [table_spec]] |
RESUME |
STATUS |
STOP |
TRACE[2] [DDLINCLUDE | DDL[ONLY]] file_name |
TRACE[2] OFF |
TRACE OFF file_name |
TRACEINIT |
THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])
}

group_name[threadID]

Nome del gruppo Replicat o di un thread specifico di Replicat coordinato, ad esempio fin003. Se il comando viene eseguito per un thread specifico, l'opzione utilizzata verrà applicata solo al thread interessato. In alternativa è possibile eseguire il comando a SEND REPLICAT con l'opzione THREADS invece di includere threadID con il nome del gruppo. Se Replicat non è in esecuzione verrà restituito un errore.

CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE}

Restituisce le statistiche relative al Cache Manager della memoria di Oracle GoldenGate. Utilizzare CACHEMGR solo dopo aver ricevuto istruzioni esplicite da parte del Supporto Oracle.

CACHESTATS

Restituisce le statistiche relative all'inserimento dei file nella cache.

CACHEQUEUES

Restituisce solo le statistiche relative alle code libere.

CACHEVMUSAGE

Restituisce le statistiche relative all'uso della memoria virtuale.

DEPENDENCYINFO [TXNCOUNT num]

Stampa le informazioni dal grafico delle dipendenze delle transazioni PR. In primo luogo stampa i gruppi di transazioni attualmente in esecuzione e quindi le transazioni in attesa che dipendono da altre transazioni. TXNCOUNT determina il numero di transazioni in attesa da stampare. Il valore predefinito è 10 e il valore massimo è 99.

FORCESTOP

Forza l'arresto di Replicat ignorando tutte le notifiche. Questo comando eseguirà il rollback di tutte le transazioni attive e arresterà immediatamente il processo. Questo comando si applica a Replicat nell'insieme e non può essere utilizzato per un thread di Replicat specifico.

GETLAG

Mostra il tempo di ritardo effettivo tra Replicat e l'origine dati. Il ritardo è la differenza, in secondi, tra l'ora di elaborazione dell'ultimo record da parte di Replicat e l'indicatore orario di tale record nel trail. I risultati sono uguali a LAG REPLICAT.

GETPARAMINFO [parameter_name] [FILE output_file]

Utilizzare GETPARAMINFO per eseguire la query sui valori dei parametri runtime di un'istanza in esecuzione, Extract, Replicat e Manager compresi. È possibile eseguire la query per un solo parametro o per tutti i parametri nonché inviare l'output alla console o a un file di testo.

parameter_name

Il funzionamento predefinito prevede la visualizzazione di tutti i parametri in uso, ovvero i parametri oggetto di query da parte dell'applicazione con i rispettivi valori correnti. Se si specifica un parametro particolare, l'output verrà filtrato in base a tale nome.

FILE output_file

Nome del file di testo al quale viene reindirizzato l'output.

HANDLECOLLISIONS NOHANDLECOLLISIONS [table_spec]

Controllare il comportamento di HANDLECOLLISIONS. Anziché utilizzare questa opzione, è possibile specificare il parametro HANDLECOLLISIONS o NOHANDLECOLLISIONS nel file dei parametri Replicat. Consulta HANDLECOLLISIONS \| NOHANDLECOLLISIONS in Riferimento su parametri e funzioni per Oracle GoldenGate. Questo comando può essere inviato direttamente a un singolo thread mediante SEND REPLICAT group_name[threadID] oppure usare l'opzione THREADS per inviarlo tramite il thread coordinatore in modo da interessare più thread.

HANDLECOLLISIONS

Utilizzare HANDLECOLLISIONS per abilitare la funzione di gestione automatica degli errori quando si eseguono i caricamenti iniziali di dati mentre il database di origine è attivo. Assicurarsi di disabilitare HANDLECOLLISIONS, emettendo SEND REPLICAT con l'opzione NOHANDLECOLLISIONS o rimuovendo il parametro dal file dei parametri, dopo che il caricamento iniziale è stato completato e le modifiche ai dati in linea sono state applicate alle tabelle di destinazione. Nota: il messaggio restituito da `SEND'

                                            REPLICAT` with `HANDLECOLLISIONS`, when issued for a specific Replicat thread, shows that the command set `HANDLECOLLISIONS` for all `MAP` statements, not only the one handled by the specified thread. This is a known issue. The command actually affects only the `MAP` statement that includes the specified thread.
                                            {: .infoboxnote}

NOHANDLECOLLISIONS

Disattiva il parametro HANDLECOLLISIONS senza tuttavia rimuoverlo dal file dei parametri. Per evitare l'abilitazione di HANDLECOLLISIONS all'avvio successivo di Replicat, rimuoverlo dal file dei parametri.

table_spec

table_spec limita HANDLECOLLISIONS o NOHANDLECOLLISIONS a un gruppo di tabelle di destinazione specifica o a un gruppo di tabelle di destinazione specificato con un carattere jolly standard (*).

INTEGRATEDPARAMS(parameter_specification)

(Oracle) Supporta Integrated Replicat. Invia una specifica di parametro al server in entrata del database mentre Replicat è in esecuzione in modalità integrata. Con questo comando è possibile inviare una sola specifica di parametro alla volta. Per inviare più modifiche a parametri, eseguire più comandi SEND REPLICAT come nell'esempio seguente.

SEND REPLICAT repe INTEGRATEDPARAMS (parallelism 4)
SEND REPLICAT repe INTEGRATEDPARAMS (max_sga_size 250)

Per garantire la continuità dell'elaborazione, la modifica del parametro viene effettuata in corrispondenza del limite di una transazione.

LOGEND

Consente di verificare se Replicat ha elaborato o meno tutti i record nell'origine dati.

REPORT [HANDLECOLLISIONS [table_spec]]

Genera un report statistico provvisorio nel file di report di Extract. Le statistiche visualizzate dipendono dalla configurazione del parametro STATOPTIONS quando utilizzato con l'opzione RESETREPORTSTATS | NORESETREPORTSTATS. Vedere STATOPTIONS.

HANDLECOLLISIONS

Mostra le tabelle per le quali è stato abilitato HANDLECOLLISIONS.

table spec

Limita l'output a una tabella di destinazione specifica o a un gruppo di tabelle di destinazione specificato con il carattere jolly asterisco (*) standard.

RESUME

Riprende (rende attivo) un processo sospeso mediante un evento EVENTACTIONS SUSPEND. Il processo riprende l'elaborazione normale dal punto in cui è stato sospeso.

STATUS

Restituisce la posizione corrente nel trail e le informazioni relative alla transazione corrente. L'output contiene i campi seguenti:

Stato elaborazione (per thread, se Replicat è coordinato)
Posizione nel file di trail (per thread, se Replicat è coordinato)
Numero di sequenza trail (per thread, se Replicat è coordinato)
RBA nel trail
Nome trail

Di seguito sono riportati i possibili messaggi di stato dell'elaborazione.

Delaying: in attesa di ulteriori dati
Suspended: in attesa della ripresa.
Waiting on deferred apply: l'elaborazione viene ritardata in base al valore del parametro DEFERAPPLYINTERVAL.
Processing data: elaborazione dei dati
Skipping current transaction: è stato utilizzato START REPLICAT con SKIPTRANSACTION.
Searching for START ATCSN csn: è stato utilizzato START REPLICAT con ATCSN.
Searching for START AFTERCSN csn: è stato utilizzato START REPLICAT con AFTERCSN.
Performing transaction timeout recovery: l'annullamento della transazione incompleta corrente e il riposizionamento per avviarne una nuova (vedere il parametro TRANSACTIONTIMEOUT).
Waiting for data at logical EOF after transaction timeout recovery: in attesa di ricevere il resto della transazione di origine incompleta dopo un'interruzione TRANSACTIONTIMEOUT.
At EOF (end of file): indica che non vi sono altri record da elaborare

I possibili messaggi dello stato del thread quando viene utilizzato THREADS o il comando viene eseguito per un thread specifico sono i seguenti:

Waiting for consensus stop point: indica che i thread tentano di sincronizzarsi per una transazione barriera.
Waiting for Watermark: indica che tutti i thread tentano di arresto in corrispondenza dello stesso limite transazioni nel trail, noto come watermark globale.
Waiting on all threads to start up: indica che il thread è in attesa dell'avvio di tutti i thread dopo una transazione barriera riuscita o l'avvio di Replicat.

Di seguito sono riportati i possibili messaggi di stato del thread coordinatore.

Waiting for all threads to register: indica che è in corso l'analisi delle istruzioni MAP per determinare gli ID thread che sono state specificate.
Processing data: indica che le informazioni vengono elaborate normalmente.
Suspended, waiting to be resumed: indica che è stato inviato a Replicat un comando SEND REPLICAT con una richiesta SUSPEND.
At EOF: indica che nel trail non vi sono più dati da elaborare.
Waiting to register MAP statistics: indica che Replicat sta raccogliendo le statistiche di elaborazione da inviare al file del report.

STOP

Arresta Replicat in modo normale. Questo comando si applica a Replicat nell'insieme e non può essere utilizzato per un thread di Replicat specifico.

THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])

Esegue il comando solo per il thread o i thread specificati di un processo Replicat coordinato. Questa opzione può essere utilizzata oppure groupname con threadID. Senza una di queste opzioni il comando verrà applicato a tutti i thread attivi.

threadID[, threadID][, ...]

Specifica un ID thread o una lista separata da virgole di thread nel formato threadID, threadID, threadID.

thread_range[, thread_range][, ...]

Specifica un intervallo di thread in formato threadIDlow-threadIDhigh o una lista di intervalli separata da virgole nel formatothreadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

La combinazione di questi formati, ad esempio threadID, threadID, threadIDlow-threadIDhigh, è consentita.

TRACE[2] [DDLINCLUDE DDL[ONLY]] file_name

Attiva e disattiva il trace. Il trace acquisisce le informazioni nel file specificato per rivelare i punti critici di elaborazione. Il trace può essere abilitato anche tramite i parametri Replicat TRACE e TRACE2.

Se il processo Replicat è in modalità coordinata e viene utilizzato TRACE con una lista o con un intervallo THREADS, verrà creato un file di trace per ogni thread attivo. Ogni nome file viene aggiunto al relativo ID thread associato. Questo metodo di identificazione dei file traccia mediante ID thread non si applica quando SEND REPLICAT viene eseguito da groupname con threadID (come in SEND REPLICAT fin003 TRACE...) oppure quando si specifica un solo thread con THREADS.

Se il trace rivela punti critici di elaborazione significativi, contattare il Supporto Oracle per assistenza.

TRACE

Acquisisce le informazioni di elaborazione passo per passo.

TRACE2

Identifica i segmenti di codice anziché i passi specifici.

DDLINCLUDE | DDLONLY

(Solo Replicat) Abilita il trace DDL e ne specifica le modalità di inclusione nel report di trace.

DDLINCLUDE include il trace DDL oltre al normale trace dell'elaborazione dei dati transazionali.
DDL[ONLY] esclude il trace dell'elaborazione dei dati delle transazioni ed esegue solo il trace delle sole istruzioni DDL. Questa opzione può essere abbreviata in DDL.

file_name

file_name specifica il nome relativo o completamente qualificato del file in cui Oracle GoldenGate registra le informazioni di trace. Se un trace è già in corso, il file traccia esistente viene chiuso e il trace riprende nel file specificato con file_name. Ad esempio:

SEND REPLICAT group_name TRACE file_name DDLINCLUDE

Se il nome file non sarà seguito da altre opzioni, è possibile omettere la parola chiave FILE. Ad esempio:

SEND REPLICAT group_name TRACE DDLINCLUDE file_name

TRACE[2] OFF

Disattiva il trace.

TRACE OFF file_name

Disattiva il trace solo per il file di trace specificato. Questa opzione supporta la funzione EVENTACTIONS, che accetta più file di trace quando vengono utilizzate più istruzioni EVENTACTIONS.

TRACEINIT

Reimposta le statistiche di trace su 0, quindi inizia di nuovo ad accumularle. Utilizzare questa opzione per tenere traccia del funzionamento corrente dell'elaborazione rispetto al funzionamento cronologico.

Esempi

SEND REPLICAT repe, HANDLECOLLISIONS

SEND REPLICAT repe, REPORT HANDLECOLLISIONS rep_*

SEND REPLICAT repe, GETLAG

SEND REPLICAT repe, INTEGRATEDPARAMS(parallelism 10)

Il comando seguente ottiene il ritardo per il thread 3 di un Replicat coordinato.

SEND REPLICAT repe, GETLAG

Il comando seguente abilita il trace solo per il thread 1 di un Replicat coordinato. In questo caso, poiché viene eseguito un solo thread, il file di trace sarà privo dell'estensione threadID. Il nome file è trace.trc.

SEND REPLICAT repe, TRACE THREADS(1) FILE ./dirrpt/trace.trc

Il comando seguente abilita il trace per i thread 1, 2 e 3 di un Replicat coordinato. supponendo che tutti i thread siano attivi, il trace produce il file trace001, trace002 e trace003.

SEND REPLICAT repe TRACE THREADS(1-3) FILE ./dirrpt/trace.trc

Il comando seguente abilita il trace solo per il thread 1 di un Replicat coordinato. Poiché il comando è stato eseguito direttamente per il thread 1, senza utilizzare una clausola THREAD, il file di trace è denominato semplicemente e trace (senza un suffisso ID thread).

SEND REPLICAT repe TRACE FILE ./dirrpt/trace.trc