SEND REPLICAT

Mit SEND REPLICAT können Sie mit einem gestarteten oder aktiven Replicat-Prozess kommunizieren. Die Anforderung wird verarbeitet, sobald Replicat Befehle von Benutzern akzeptieren kann.

Syntax

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]

Der Name der Replicat-Gruppe oder der Name eines bestimmten Threads eines koordinierten Replicats. Beispiel: fin003. Wenn Sie den Befehl für einen bestimmten Thread ausgeben, gilt eine verwendete Option nur für diesen Thread. Als Alternative können Sie SEND REPLICAT mit der Option THREADS ausgeben, anstatt threadID mit dem Gruppennamen anzugeben. Wenn Replicat nicht ausgeführt wird, wird ein Fehler zurückgegeben.

CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE}

Gibt Statistiken zum Oracle GoldenGate-Speicher-Cache Manager zurück. CACHEMGR darf nur auf explizite Anweisung von Oracle Support verwendet werden.

CACHESTATS

Gibt Statistiken für das Datei-Caching zurück.

CACHEQUEUES

Gibt nur Statistiken für die freien Queues zurück.

CACHEVMUSAGE

Gibt Statistiken für die Auslastung des virtuellen Arbeitsspeichers zurück.

DEPENDENCYINFO [TXNCOUNT num]

Druckt Informationen aus dem PR-Transaktionsabhängigkeitsdiagramm. Zuerst werden die Transaktionsgruppen gedruckt, die gerade ausgeführt werden, und dann die wartenden Transaktionen, die von anderen Transaktionen abhängig sind. TXNCOUNT bestimmt die Anzahl der zu druckenden wartenden Transaktionen. Der Standardwert ist 10 und der Höchstwert 99.

FORCESTOP

Erzwingt den Replicat-Stopp und umgeht dabei alle Benachrichtigungen. Mit diesem Befehl wird ein Rollback für alle aktiven Transaktionen durchgeführt und der Prozess sofort gestoppt. Dieser Befehl gilt für Replicat als Ganzes und kann nicht für einen bestimmten Replicat-Thread verwendet werden.

GETLAG

Zeigt die echte Verzögerungszeit zwischen Replicat und dem Trail an. Die Verzögerungszeit ist die Differenz in Sekunden zwischen der Verarbeitungszeit des letzten Datensatzes durch Replicat und dem Zeitstempel des Datensatzes im Trail. Die Ergebnisse sind mit dem Wert LAG REPLICAT identisch.

GETPARAMINFO [parameter_name] [FILE output_file]

Mit GETPARAMINFO können Sie Laufzeitparameterwerte einer aktiven Instanz abfragen, darunter Extract, Replicat und Manager. Sie können einen einzelnen Parameter oder alle Parameter abfragen und die Ausgabe an die Konsole oder eine Textdatei senden.

parameter_name

Standardmäßig werden alle verwendeten Parameter angezeigt, also die Parameter, die bisher von der Anwendung abgefragt wurden, andere Parameter und deren aktuelle Werte. Wenn Sie einen bestimmten Parameter angeben, wird die Ausgabe nach diesem Namen gefiltert.

FILE output_file

Der Name der Textdatei, an die die Ausgabe umgeleitet wird.

HANDLECOLLISIONS NOHANDLECOLLISIONS [table_spec]

Steuern Sie das Verhalten HANDLECOLLISIONS. Anstatt diese Option zu nutzen, können Sie den Parameter HANDLECOLLISIONS oder NOHANDLECOLLISIONS in der Replicat-Parameterdatei angeben. Siehe HANDLECOLLISIONS \| NOHANDLECOLLISIONS in der Referenz zu Parametern und Funktionen für Oracle GoldenGate. Dieser Befehl kann überSEND REPLICAT group_name[threadID] direkt an einen einzelnen Thread gesendet werden, oder Sie können die Option THREADS verwenden, um den Befehl über den Koordinatorthread zu senden, sodass sie mehrere Threads betrifft.

HANDLECOLLISIONS

Verwenden Sie HANDLECOLLISIONS, um die automatische Fehlerbehandlung bei anfänglichen Dataloads zu aktivieren, während die Quelldatenbank aktiv ist. Deaktivieren Sie HANDLECOLLISIONS, indem Sie SEND REPLICAT mit der Option NOHANDLECOLLISIONS absetzen oder den Parameter aus der Parameterdatei entfernen, nachdem das anfängliche Laden abgeschlossen ist und Online-Datenänderungen auf die Zieltabellen angewendet wurden. Hinweis: Die von "SEND" zurückgegebene Nachricht

                                            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

Schaltet den Parameter HANDLECOLLISIONS aus, entfernt ihn aber nicht aus der Parameterdatei. Um zu vermeiden, dass HANDLECOLLISIONS beim nächsten Replicat-Start deaktiviert wird, entfernen Sie ihn aus der Parameterdatei.

table_spec

table_spec schränkt HANDLECOLLISIONS oder NOHANDLECOLLISIONS auf eine bestimmte Zieltabelle oder eine mit einem Standardplatzhalter (*) angegebene Gruppe aus Zieltabellen ein.

INTEGRATEDPARAMS(parameter_specification)

(Oracle) Unterstützt ein integriertes Replicat. Sendet eine Parameterspezifikation an den Datenbankeingangsserver, während Replicat im integrierten Modus ausgeführt wird. Mit diesem Befehl kann jeweils immer nur eine Parameterspezifikation gesendet werden. Um mehrere Parameteränderungen zu senden, geben Sie mehrere SEND REPLICAT-Befehle wie im folgenden Beispiel gezeigt aus.

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

Um die kontinuierliche Verarbeitung aufrecht zu erhalten, wird die Parameteränderung an der Transaktionsgrenze vorgenommen.

LOGEND

Bestätigt, ob Replicat alle Datensätze in der Datenquelle verarbeitet hat oder nicht.

REPORT [HANDLECOLLISIONS [table_spec]]

Generiert einen statistischen Zwischenbericht für die Extract-Berichtsdatei. Welche Statistiken angezeigt werden, hängt von der Konfiguration des Parameters STATOPTIONS bei der Verwendung mit der Option RESETREPORTSTATS | NORESETREPORTSTATS ab. Siehe STATOPTIONS.

HANDLECOLLISIONS

Zeigt Tabellen an, für die HANDLECOLLISIONS aktiviert wurde.

table spec

Schränkt die Ausgabe auf eine bestimmte Zieltabelle oder eine mit einem Standardplatzhalter (*) angegebene Gruppe aus Zieltabellen ein.

RESUME

Setzt einen Prozess fort (aktiviert), der von einem EVENTACTIONS SUSPEND-Ereignis unterbrochen wurde, und macht ihn aktiv. Der Prozess nimmt die normale Verarbeitung an dem Punkt wieder auf, an dem er unterbrochen wurde.

STATUS

Gibt die aktuelle Position im Trail sowie Informationen zur aktuellen Transaktion zurück. Folgende Felder werden ausgegeben:

Verarbeitungsstatus (pro Thread bei koordiniertem Replicat)
Position in der Traildatei (pro Thread bei koordiniertem Replicat)
Trailsequenznummer (pro Thread bei koordiniertem Replicat)
RBA im Trail
Trailname

Folgende Meldungen zum Verarbeitungsstatus sind möglich:

Delaying: Es wird auf weitere Daten gewartet
Suspended: Es wird auf das Fortsetzen des Vorgangs gewartet
Waiting on deferred apply: Verarbeitung wird basierend auf dem Parameter DEFERAPPLYINTERVAL verzögert.
Processing data: Datenverarbeitung
Skipping current transaction: START REPLICAT mit SKIPTRANSACTION wurde verwendet.
Searching for START ATCSN csn: START REPLICAT mit ATCSN wurde verwendet.
Searching for START AFTERCSN csn: START REPLICAT mit AFTERCSN wurde verwendet.
Performing transaction timeout recovery: Die aktuelle unvollständige Transaktion wird abgebrochen, und die Position zum Starten einer neuenstransaktion wird festgelegt (siehe Parameter TRANSACTIONTIMEOUT).
Waiting for data at logical EOF after transaction timeout recovery: Es wird nach einer Beendigung über TRANSACTIONTIMEOUT auf den Erhalt des Restes der unvollständigen Quelltransaktion gewartet.
At EOF (end of file): Keine weiteren Datensätze zur Verarbeitung vorhanden.

Die folgenden Threadstatusmeldungen sind zulässig, wenn THREADS verwendet wird oder der Befehl für einen bestimmten Thread ausgegeben wird:

Waiting for consensus stop point: Gibt an, dass die Threads versuchen, für eine Grenzwerttransaktion eine Synchronisierung durchzuführen.
Waiting for Watermark: Gibt an, dass alle Threads versuchen, bei derselben Transaktionsgrenze im Trail zu stoppen (auch als globales Watermark bezeichnet).
Waiting on all threads to start up: Gibt an, dass der Thread nach einer erfolgreichen Sperrtransaktion oder einem Replicat-Start auf den Start aller Threads wartet.

Folgende Meldungen zum Koordinatorthreadstatus sind möglich:

Waiting for all threads to register: Gibt an, dass die MAP-Anweisungen alle geparst werden, um die darin angegebenen Thread-IDs zu bestimmen.
Processing data: Gibt an, dass Daten normal verarbeitet werden.
Suspended, waiting to be resumed: Gibt an, dass ein SEND REPLICAT-Befehl mit einer SUSPEND-Anforderung an Replicat gesendet wurde.
At EOF: Gibt an, dass keine weiteren zu verarbeitenden Daten im Trail vorhanden ist.
Waiting to register MAP statistics: Gibt an, dass Replicat Verarbeitungsstatistiken für die Berichtsdatei erfasst.

STOP

Stoppt Replicat ordnungsgemäß. Dieser Befehl gilt für Replicat als Ganzes und kann nicht für einen bestimmten Replicat-Thread verwendet werden.

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

Gibt den Befehl nur für den bzw. die angegebenen Threads eines koordinierten Replicats aus. Sie können diese Option verwenden oder groupname zusammen mit threadID verwenden. Ohne diese Optionen gilt der Befehl für alle aktiven Threads.

threadID[, threadID][, ...]

Gibt eine Thread-ID oder eine kommagetrennte Liste mit Threads im Format threadID, threadID, threadID an.

thread_range[, thread_range][, ...]

Gibt einen Threadbereich in Form von threadIDlow-threadIDhigh oder einer durch Komma getrennten Liste von Bereichen im Format von threadIDlow-threadIDhigh, threadIDlow-threadIDhigh an.

Eine Kombination aus diesen Formaten ist ebenfalls zulässig, wie threadID, threadID, threadIDlow-threadIDhigh.

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

Schaltet das Tracing ein bzw. aus. Das Tracing erfasst Informationen in der angegebenen Datei, um Verarbeitungsengpässe aufzudecken. Das Tracing kann auch über die Replicat-Parameter TRACE und TRACE2 aktiviert werden.

Wenn sich das Replicat im koordinierten Modus befindet und TRACE mit einer THREADS-Liste oder eines Bereichs verwendet wird, wird eine Tracedatei für jeden derzeit aktiven Thread erstellt. An jeden Dateinamen wird die zugehörige Thread-ID angehängt. Diese Methode zur Identifizierung von Tracedateien nach Thread-ID gilt nicht, wenn SEND REPLICAT von groupname mit threadID ausgegeben wird (wie in SEND REPLICAT fin003 TRACE...) oder wenn nur ein Thread mit THREADS angegeben wird.

Bitten Sie Oracle Support um Hilfe, wenn das Trace wesentliche Verarbeitungsengpässe offenlegt.

TRACE

Erfasst Schritt-für-Schritt-Verarbeitungsinformationen.

TRACE2

Identifiziert Codesegmente anstelle spezifischer Schritte.

DDLINCLUDE | DDLONLY

(Nur Replicat) Aktiviert das DDL-Tracing und gibt an, wie das DDL-Tracing in den Tracebericht aufgenommen wird.

DDLINCLUDE umfasst das DDL-Tracing zusätzlich zum regulären Tracing der Verarbeitung von Transaktionsdaten.
Mit DDL[ONLY] schließen Sie das Tracing der Transaktionsdatenverarbeitung aus und tracen nur DDL. Diese Option kann mit DDL abgekürzt werden.

file_name

file_name gibt den relativen oder vollqualifizierten Namen einer Datei an, in der Oracle GoldenGate die Traceinformationen protokolliert. Wenn bereits ein Trace ausgeführt wird, wird die vorhandene Tracedatei geschlossen, und das Trace wird mit der unter file_name angegebenen Datei wiederaufgenommen. Beispiel:

SEND REPLICAT group_name TRACE file_name DDLINCLUDE

Wenn keine weiteren Optionen auf den Dateinamen folgen, können Sie das Schlüsselwort FILE auslassen. Beispiel:

SEND REPLICAT group_name TRACE DDLINCLUDE file_name

TRACE[2] OFF

Deaktiviert das Tracing.

TRACE OFF file_name

Deaktiviert das Tracing nur für die angegebene Tracedatei. Diese Option unterstützt das Feature EVENTACTIONS. Dabei können aufgrund mehrerer EVENTACTIONS-Anweisungen mehrere Tracedateien vorhanden sein.

TRACEINIT

Setzt die Tracingstatistiken auf 0 zurück und beginnt dann erneut mit der Erfassung von Statistiken. Mit dieser Option können Sie das aktuelle Verarbeitungsverhalten anstelle des historischen Verhaltens verfolgen.

Beispiele

SEND REPLICAT repe, HANDLECOLLISIONS

SEND REPLICAT repe, REPORT HANDLECOLLISIONS rep_*

SEND REPLICAT repe, GETLAG

SEND REPLICAT repe, INTEGRATEDPARAMS(parallelism 10)

Mit dem folgenden Befehl rufen Sie die Verzögerung für Thread 3 eines koordinierten Replicats ab.

SEND REPLICAT repe, GETLAG

Mit dem folgenden Befehl aktivieren Sie das Tracing nur für Thread 1 eines koordinierten Replicats. Da in diesem Fall nur ein Thread verfolgt wird, weist die Tracedatei keine threadID-Erweiterung auf. Der Dateiname lautet trace.trc.

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

Mit dem folgenden Befehl aktivieren Sie das Tracing für Threads 1, 2 und 3 eines koordinierten Replicats. Wenn alle Threads aktiv sind, erzeugt die Tracing-Dateien trace001, trace002 und trace003.

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

Mit dem folgenden Befehl aktivieren Sie das Tracing nur für Thread 1 eines koordinierten Replicats. Da der Befehl direkt für Thread 1 ohne eine THREAD-Klausel ausgegeben wurde, erhält die Tracedatei die Bezeichnung trace (ohne Thread-ID-Suffix).

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