SEND EXTRACT
Mit SEND EXTRACT können Sie mit einem aktiven Extract-Prozess kommunizieren. Die Anforderung wird verarbeitet, sobald Extract Befehle von Benutzern akzeptieren kann.
Syntax
SEND EXTRACT group_name, {
BR {BRINTERVAL interval |
BRSTART |
BRSTOP |
BRCHECKPOINT {IMMEDIATE | IN n{M|H} | AT yyyy-mm-dd hh:mm[:ss]]}} |
BR BRFSOPTION { MS_SYNC | MS_ASYNC }
BR BRSTATS
BR BRSTATUS
CACHEMGR {CACHESTATS {ALL | MINIMAL | SUPERPOOL | CURRENTONLY | POOLS | POOL n | QUEUES} | CACHEQUEUES | CACHEVMUSAGE} |
FORCESTOP |
FORCETRANS transaction_ID [FORCE] |
GETLAG |
GETPARAMINFO [parameter_name] [FILE output_file] |
GETTCPSTATS |
LOGEND |
LOGSTATS |
REPORT |
RESUME |
ROLLOVER |
SHOWTRANS [transaction_ID] [COUNT n]
[DURATION duration unit] [TABULAR]
[FILE file_name [DETAIL]] [ALL]|
SKIPTRANS transaction_ID [FORCE] |
STATUS |
STOP |
TRACE[2] file_name |
TRACE[2] OFF |
TRACE OFF file_name |
TRACEINIT |
TRANLOGOPTIONS INTEGRATEDPARAMS(parameter_specification) |
TRANLOGOPTIONS {TRANLOGOPTIONS {PURGEORPHANEDTRANSACTIONS | NOPURGEORPHANEDTRANSACTIONS} |
TRANLOGOPTIONS TRANSCLEANUPFREQUENCY minutes |
VAMMESSAGE 'Teradata_command' |
VAMMESSAGE {'ARSTATS' | 'INCLUDELIST [filter]' | 'FILELIST [filter]'| 'EXCLUDELIST [filter]'} |
VAMMESSAGE 'OPENTRANS'
}
group_name
Der Name der Extract-Gruppe oder ein Platzhalter (), um mehrere Gruppen anzugeben. Beispiel: Mit T senden Sie den Befehl an alle Extract-Prozesse, deren Gruppennamen mit "T" beginnen. Wenn ein Extract nicht ausgeführt wird, wird ein Fehler zurückgegeben.
BR {BRINTERVAL interval |
BRSTART |
BRSTOP |
|
BRCHECKPOINT {IMMEDIATE |
IN n {H |
M} |
AT yyyy-mm-dd[ hh:mm[:ss]]}} |
Sendet Befehle, die sich auf den Bounded Recovery-Modus von Extract auswirken.
BRINTERVAL interval
Legt die Zeit zwischen Bounded Recovery Checkpoints fest. Gültige Werte: 20 Minuten bis 96 Stunden, mit der Angabe M für Minuten oder H für Stunden. Beispiel: 20M oder 2H. Das Standardintervall beträgt 4 Stunden.
BRSTART
Startet Bounded Recovery. Dieser Befehl darf nur auf Anweisung von Oracle Support verwendet werden.
BRSTOP
Stoppt Bounded Recovery für die Ausführung und für Recovery. Verwenden Sie diese Option erst nach Rücksprache mit Oracle Support. In den meisten Fällen wird Bounded Recovery automatisch ausgeschaltet, wenn ein Problem damit vorliegt.
BRCHECKPOINT {IMMEDIATE |
IN n{H |
M} |
AT yyyy-mm-dd[ hh:mm[:ss]]}} |
Legt den Punkt fest, an dem ein Bounded Recovery Checkpoint erstellt wird. IMMEDIATE gibt den Checkpoint sofort bei Ausführung vonSEND EXTRACT aus. IN gibt den Checkpoint in der angegebenen Anzahl an Stunden oder Minuten ab, wenn SEND EXTRACT ausgegeben wird. AT gibt den Checkpoint genau zur angegebenen Zeit ab.
BR BRFSOPTION {MS_SYNC | MS_ASYNC}
Führt synchrone/asynchrone Schreibvorgänge der zugeordneten Daten in Bounded Recovery aus.
MS_SYNC
Bounded Recovery-Schreibvorgänge zugeordneter Daten werden für den I/O-Datenintegritätsabschluss synchronisiert.
MS_ASYNC
Bounded Recovery-Schreibvorgänge zugeordneter Daten werden zur Verarbeitung initiiert oder in die Queue gestellt.
BR BRSTATS
Gibt Details zu den einzelnen Objektpools an, die von BR persistiert wurden. Dazu gehören die folgenden Details:
-
Objektgrößenwerte während der Lebensdauer der Extract-Gruppe
-
Objektalterswerte während der Lebensdauer der Extract-Gruppe
-
Bestehende Objektgrößenwerte seit dem letzten BCP
-
Bestehende Objektalterswerte seit dem letzten BCP
BR BRSTATUS
Gibt den Status für den Bounded Recovery-Modus von Extract zurück.
Zeigt Folgendes an:
-
Aktuelle Einstellungen des BR-Parameters.
-
Aktuellen Status von Bounded Recovery (falls durchgeführt) mit aktuellem Checkpoint-Intervall, Zeitstempeln für den nächsten und den letzten Checkpoint sowie Gesamtanzahl Objekte und Anzahl der ausstehenden Objekte und Größenwerte, wenn BR durchgeführt wird.
-
Start- und Endsequenz, RBA, SCN und Zeitstempel für die Bounded Recovery-Checkpoint-Positionen (gemäß Redo-Thread).
CACHESTATS {ALL |
MINIMAL |
SUPERPOOL |
CURRENTONLY |
POOLS |
POOL n |
QUEUES} |
CACHESTATS gibt Statistiken für die Auslastung des virtuellen Arbeitsspeichers und das Datei-Caching wieder.
ALL
Gibt alle COM-Statistiken zurück und ist die Standardoption.
MINIMAL
Gibt die gekürzte (minimale) Version der COM-Statistiken wieder, während CACHEALL alle Statistiken zurückgibt.
SUPERPOOL
Superpoolstatistiken. Gibt Statistiken zu allen Objektpools zurück.
CURRENTONLY
Gibt nur Statistiken für die Laufzeit zurück.
POOLS
Gibt Statistiken für alle Objektpools zurück.
POOL n
Gibt nur Statistiken für den angegebenen Objektpool zurück.
QUEUES
Gibt nur Statistiken für Queues zurück.
CACHEVMUSAGE
Gibt Statistiken für die Auslastung des virtuellen Arbeitsspeichers zurück
FORCESTOP
Erzwingt den Extract-Stopp und umgeht dabei alle Benachrichtigungen. Mit diesem Befehl wird der Prozess sofort gestoppt.
FORCETRANS transaction_ID ] [FORCE]
Gültig für Db2 LUW, Db2 IBM, MySQL, Oracle und SQL Server.
Setzt durch, dass Extract eine durch die Transaktions-ID-Nummer angegebene Transaktion als festgeschriebene Transaktion in den Trail schreibt. FORCETRANS schreibt die Transaktion nicht in der Quelldatenbank fest. Die vorhandenen Daten werden lediglich für die Verarbeitung (mit einem impliziten Befehl) durch Replicat an den Trail übertragen. Sie können FORCETRANS für andere Transaktionen nach Alter wiederholen. Das Erzwingen eines Transaktions-Commits im Trail (und daher in der Zieldatenbank) kann zu Datendiskrepanzen führen, wenn die Transaktion von den Quellbenutzeranwendungen zurückgerollt wird.
Warten Sie nach der Verwendung von FORCETRANS mindestens fünf Minuten, bevor Sie SEND EXTRACT mit FORCESTOP ausgeben. Andernfalls ist die Transaktion immer noch vorhanden.
Wenn FORCETRANS direkt nach Extract-Start verwendet wird, wird möglicherweise eine Fehlermeldung angezeigt, in dem Sie aufgefordert werden, zu warten, und den Befehl dann erneut zu wiederholen. Das bedeutet, dass noch keine anderen Transaktionen von Extract verarbeitet wurden. Wenn eine andere Transaktion verarbeitet wurde, können Sie das Schreiben der Transaktion in den Trail erzwingen.
transaction_ID
Die ID der Transaktion. Rufen Sie die Transaktions-ID-Nummer mit SHOWTRANS oder von einer Extract-Laufzeitnachricht ab. Extract ignoriert alle Daten, die nach Ausgabe dieses Befehls zur Transaktion hinzugefügt werden. Ein Bestätigungs-Prompt muss beantwortet werden, es sei denn, FORCE wird verwendet. Zur Verwendung von FORCETRANS muss die angegebene Transaktion die älteste in der Transaktionslisten sein, die mit SHOWTRANS angezeigt wird.
FORCE
Gültig für Oracle und SQL Server. Nicht für MySQL gültig.
Verwenden Sie FORCE, um den Bestätigungs-Prompt zu umgehen.
GETLAG
Bestimmt die echte Verzögerungszeit zwischen Extract und der Datenquelle. Gibt dieselben Ergebnisse wie LAG EXTRACT zurück.
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.
GETTCPSTATS
Zeigt Statistiken zu Netzwerkaktivitäten zwischen Extract und dem Zielsystem an. Diese Statistiken umfassen:
-
Lokale und Remote-IP-Adressen.
-
Eingehende und ausgehende Nachrichten, in Byte und Byte pro Sekunde.
-
Anzahl der Empfangsvorgänge (eingehend) und Sendevorgänge (ausgehend). Es gibt mindestens zwei Empfangsvorgänge pro eingehender Nachricht: einen für die Länge und mindestens einen für die Daten.
-
Durchschnittliche Byte pro Sende- und Empfangsvorgang.
-
Sende- und Empfangswartezeit: Die Sendewartezeit gibt die Zeitspanne bis zum Abschluss des Schreibvorgangs in TCP an. Je niedriger die Sendewartezeit, desto besser die Netzwerkperformance. Die Empfangswartezeit gibt die Zeitspanne bis zum Abschluss des Lesevorgangs an. Zusammen geben die Sende- und die Empfangswartezeit eine grobe Schätzung der Netzwerk-Roundtrip-Zeit an. Diese Werte werden in Mikrosekunden ausgedrückt.
-
Status der Datenkomprimierung (aktiviert oder deaktiviert).
-
Nicht komprimierte Byte und komprimierte Byte: Im Vergleich (zwischen nicht komprimiert und komprimiert) geben diese Werte das Komprimierungsverhältnis an, also wie viele Byte vor und nach der Komprimierung vorhanden waren. Sie können das Komprimierungsverhältnis mit den pro Sekunde komprimierten Byte vergleichen, um zu bestimmen, ob die Komprimierungsrate sich angesichts der höheren Ressourcen- und Netzwerkauslastung lohnt.
Die Option TCPBUFSIZE von RMTHOST und RMTHOSTOPTIONS steuert die Größe des TCP-Puffers für nicht komprimierte Daten. Die tatsächlich in das Netzwerk eingehenden Daten liegen unter dieser Größe, wenn die Komprimierung aktiviert ist. GETTCPSTATS zeigt den Durchsatz nach der Komprimierung.
LOGEND
Bestätigt, ob Extract alle Datensätze in der Datenquelle verarbeitet hat oder nicht.
LOGSTATS
Nur für Oracle gültig.
Weist Extract an, einen Bericht zu den Statistiken im Zusammenhang mit der Verarbeitung von Daten aus den Oracle-Redo-Logdateien auszugeben. Extract verwendet einen asynchronen Log-Reader, der Datensätze vor der Extract-Verarbeitung liest, damit die Daten ohne zusätzlichen I/O in den Logdateien verfügbar sind. Die Verarbeitung erfolgt über eine Reihe von Lese-/Schreibqueues. Daten werden von einem Producerthread geparst, während gleichzeitig zusätzliche Daten von einem Reader-Thread aus der Logdatei gelesen werden. Daher wird der Begriff "Read-Ahead" in den Statistiken verwendet.
Statistiken:
-
AsyncReader.Buffersn: Für jede Pufferqueue, die erfasste Redo-Daten enthält, ist ein Feld wie dieses vorhanden. Es zeigt die Größe, die Anzahl der enthaltenen Datensätze und die Wartezeit vor der Datenverarbeitung an. Diese Statistiken werden für Schreib- und Lesevorgänge in der Queue ausgegeben. -
REDOread-ahead-Puffer: Die Anzahl von Puffern, die für asynchrone Read-ahead verwendet werden. -
REDOread-forward-Puffergröße: Die Größe jedes Puffers. -
REDObytes read ahead for current redo: Gibt an, ob der Read-Ahead-Modus für das aktuelle Redo-Log ein- oder ausgeschaltet war (WertONoderOFF). -
REDObytes read: Die Anzahl der gelesenen Byte aus allen Redo-Logdateien, die mit dieser Extract-Instanz verknüpft sind. -
REDOBytes read ahead: Die Anzahl der Bytes, die vom Read-Ahead-Mechanismus verarbeitet worden sind. -
REDO bytes unused: Die Anzahl der Read-Ahead-Byte, die anschließend aufgrund von Extract-Positionsänderungen oder veralteten Lesevorgängen gelöscht wurden.
-
REDOByte parsed: Die Anzahl der Byte, die als gültige Logdaten verarbeitet wurden. -
REDOByte-Ausgabe: Die Anzahl der Byte, die in die Traildatei geschrieben wurden (ohne internen Oracle GoldenGate-Overhead).
REPORT
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.
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.
ROLLOVER
Damit wechselt Extract zur nächsthöheren Datei im Trail bei einem Neustart. Beispiel: Wenn die aktuelle Datei ET000002 ist und der Befehl ausgeführt wird, lautet die aktuelle Datei anschließend ET000003. Ein Trail kann von 000001 bis 999999 erhöht werden. Dann beginnt die Sequenznummerierung wieder bei 000000.
SHOWTRANS [transaction_ID] [COUNT n] [DURATION duration unit] [TABULAR] | [FILE file_name [DETAIL]] [ALL]
Gültig für Db2 IBM, Db2 LUW, Db2 z/OS, MySQL, Oracle und SQL Server.
Zeigt Informationen zu offenen Transaktionen an. SHOWTRANS zeigt je nach Datenbanktyp folgende Informationen an:
-
Prozess-Checkpoint (gibt das älteste Log an, das erforderlich ist, um die Verarbeitung der Transaktion bei einem Extract-Neustart fortzusetzen)
-
Transaktions-ID
-
Extract-Gruppenname
-
Redo-Threadnummer
-
Zeitstempel des ersten Vorgangs, den Oracle GoldenGate aus einer Transaktion extrahiert (nicht die tatsächliche Startzeit der Transaktion)
-
Systemänderungsnummer (SCN)
-
Redo-Lognummer und RBA
-
Status (
Pending COMMIToderRunning).Pending COMMITwird angezeigt, während eine Transaktion nach der Ausgabe vonFORCETRANSgeschrieben wird.
Ohne Optionen zeigt SHOWTRANS alle offenen Transaktionen an, die in den verfügbaren Puffer passen. Manchmal wird allerdings nicht der Ausgabebenutzername für eine offene aktive Transaktion angezeigt, weil der Benutzername nicht im Begin-Datensatz aus dem Transaktionslog angegeben wurde.
In den Beispielen finden Sie eine Beispielausgabe von SHOWTRANS. Mit den folgenden Optionen können Sie die Ausgabe weiter kontrollieren.
transaction_ID
Begrenzt die Befehlsausgabe auf eine bestimmte Transaktion.
COUNT n
Schränkt die Ausgabe auf die angegebene Anzahl offener Transaktionen ein, beginnend mit der ältesten. Gültige Werte sind 1 bis 1000.
DURATION duration unit
Schränkt die Ausgabe auf Transaktionen ein, die länger als die angegebene Zeit offen sind. Dabei gilt:
duration ist die als Ganzzahl ausgedrückte Zeitspanne.
unit ist eine der folgenden Optionen, um seconds, minutes, hours oder days auszudrücken:
S|SEC|SECS|SECOND|SECONDS
M|MIN|MINS|MINUTE|MINUTES
H|HOUR|HOURS
D|DAY|DAYS
TABULAR
Nur für Oracle gültig.
Generiert eine Ausgabe im Tabellenformat ähnlich wie die Standardtabellenausgabe mit SQL*Plus. Standardmäßig wird ein Feld pro Zeile angezeigt.
FILE file_name [DETAIL]
Nur für Oracle und SQL Server gültig. Nicht für MySQL gültig.
Setzt durch, dass Extract die Transaktionsinformationen in die angegebene Datei schreibt. Es werden keine Daten an die Konsole ausgegeben.
Bei Oracle können Sie einen Datendump in Hexadezimal- und Klartextzeichen über FILE mit DETAIL schreiben. Dadurch wird die ganze Transaktion aus dem Arbeitsspeicher in die Datei weggeschrieben. Anhand der Daten können Sie unter Umständen bestimmen, ob die Transaktion übersprungen oder erzwungenermaßen in den Trail geschrieben werden soll.
Hinweis: Einfache Detailinformationen werden automatisch in den mit dem Parameter WARNLONGTRANS angegebenen Intervallen in die Berichtsdatei geschrieben.
CHECKINTERVAL` parameter.
{: .infoboxnote}
[ALL]
Diese Option ermöglicht das Anzeigen aller Transaktionen in COM. Sie ist nützlich beim Erkennen potenzieller Probleme mit festgeschriebenen Transaktionen, die in COM verbleiben.
SKIPTRANS transaction_ID [FORCE]
Gültig für Db2 LUW, Db2 IBM, MySQL, Oracle und SQL Server.
Setzt durch, dass Extract die angegebene Transaktion überspringt. Dadurch werden alle aktuellen Daten aus dem Arbeitsspeicher entfernt und nachfolgende Daten ignoriert. Ein Bestätigungs-Prompt muss beantwortet werden, es sei denn, FORCE wird verwendet. Warten Sie nach der Verwendung von SKIPTRANS mindestens fünf Minuten, bevor Sie SEND EXTRACT mit FORCESTOP ausgeben. Andernfalls ist die Transaktion immer noch vorhanden. Beachten Sie, dass das Überspringen einer Transaktion zu Datenverlust in der Zieldatenbank führen kann.
Hinweis: Zur Verwendung von SKIPTRANS muss die angegebene Transaktion die älteste in der Liste der Transaktionen sein, die mit SHOWTRANS angezeigt wird. Sie können den Befehl für andere Transaktionen nach Alter angeordnet wiederholen.
transaction_ID
Die Transaktions-ID-Nummer. Rufen Sie die ID-Nummer mit SHOWTRANS oder von einer Extract-Laufzeitnachricht ab.
FORCE
Gültig für Oracle und SQL Server. Nicht für MySQL gültig.
Mit FORCE können Sie den Prompt umgehen, der bestätigt, dass Sie die Transaktion überspringen möchten.
STATUS
Gibt einen detaillierten Status der Verarbeitung zurück, einschließlich der aktuellen Position und Aktivität. Mögliche Verarbeitungsstatusmeldungen in der Zeile Current status:
-
Delaying: Auf weitere Daten warten -
Suspended: Es wird auf das Fortsetzen des Vorgangs gewartet -
Processing data: Daten werden verarbeitet -
Starting initial load: Anfängliche Ladeaufgabe starten -
Processing source tables: Daten für anfängliche Ladeaufgabe werden verarbeitet -
Reading from data source: Daten werden aus der Datenquelle gelesen (z.B. Quelltabelle oder Transaktionslog) -
Adding record to transaction list: Ein Datensatz wird zur Transaktionsliste des Dateispeichers hinzugefügt -
At EOF (end of file): Keine weiteren Datensätze zur Verarbeitung vorhanden.
Zusätzlich zu den vorangehenden Statusangaben werden die folgenden Statusnotationen bei einem Extract-Recovery nach einem anormalen Ende angezeigt. Sie können den Fortschritt verfolgen, während Extract kontinuierlich seine Logleseposition während des Recoverys ändert.
-
In recovery[1]: Extract führt das Recovery zu seinem Checkpoint im Transaktionslog aus. -
In recovery[2]: Extract wird vom Checkpoint bis zum Ende des Trails wiederhergestellt. -
Recovery complete: Das Recovery ist abgeschlossen, und die normale Verarbeitung wird fortgesetzt.
STOP
Stoppt Extract. Wenn Transaktionen mit langer Ausführungszeit (basierend auf dem Parameter WARNLONGTRANS) vorhanden sind, wird folgende Meldung angezeigt:
Sending STOP request to EXTRACT EXTE...
There are open, long-running transactions. Before you stop Extract, make the archives containing data for those transactions available for when Extract restarts. To force Extract to stop, use the SEND EXTRACT group, FORCESTOP command.
Oldest redo log file necessary to restart Extract is:
Redo Thread 1, Redo Log Sequence Number 150, SCN 31248005, RBA
2912272.
TRACE[2] {file_name |
OFF} |
Schaltet das Tracing ein bzw. aus. Das Tracing erfasst Informationen in der angegebenen Datei, um Verarbeitungsengpässe aufzudecken. 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.
file_name
Gibt den Namen der Datei an, in die die Traceinformationen geschrieben werden. Wenn bei Ausgabe vonSEND EXTRACT mit TRACE bereits ein Trace ausgeführt wird, wird die vorhandene Tracedatei geschlossen, und das Trace wird mit der über file_name angegebenen neuen Datei wiederaufgenommen.
OFF
Deaktiviert das Tracing.
TRACE OFF file_name
Deaktiviert das Tracing nur für die angegebene Tracedatei.
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.
TRANLOGOPTIONS INTEGRATEDPARAMS(parameter_specification)
(Oracle) Unterstützt einen integrierten Extract. Sendet eine Parameterspezifikation an den Datenbankeingangsserver, während Extract im integrierten Modus ausgeführt wird. Mit diesem Befehl kann jeweils immer nur eine Parameterspezifikation gesendet werden. Sie können mehrere Parameteränderungen senden, wobei Sie mehrere SEND EXTRACT-Befehle ausgeben.
Um die kontinuierliche Verarbeitung aufrecht zu erhalten, wird die Parameteränderung an der Transaktionsgrenze vorgenommen.
TRANLOGOPTIONS {PURGEORPHANEDTRANSACTIONS | NOPURGEORPHANEDTRANSACTIONS}
Gültig für Oracle RAC. Aktiviert bzw. deaktiviert das Löschen verwaister Transaktionen, die auftreten, wenn ein Knoten einen Fehler aufweist und Extract das Rollback nicht erfassen kann.
TRANLOGOPTIONS TRANSCLEANUPFREQUENCY minutes
Gültig für Oracle RAC. Gibt das Intervall in Minuten an, in dem Oracle GoldenGate nach verwaisten Transaktionen sucht, den Scan zur Bestätigung wiederholt und diese Transaktionen löscht. Gültige Werte liegen zwischen 1 und 43200 Minuten. Der Standardwert beträgt 10 Minuten.
VAMMESSAGE ‘Teradata_command’ VAMMESSAGE { 'ARSTATS' | 'INCLUDELIST [filter]' | 'EXCLUDELIST [filter]' }
Sendet einen Befehl an die Capture-API, die von Extract verwendet wird.
Die folgenden Teradata-Befehle sind möglich:
‘control:terminate’
Stoppt eine Replikationsgruppe. Erforderlich, bevor Sie eine Replikationsgruppe in Teradata löschen oder ändern.
‘control:suspend’
Unterbricht eine Replikationsgruppe. Kann beim Upgrade von Oracle GoldenGate verwendet werden.
‘control:resume’
Nimmt eine Replikationsgruppe nach ihrer Unterbrechung wieder auf.
‘control:copy database.table’
Kopiert eine Tabelle aus der Quelldatenbank in die Zieldatenbank.
'ARSTATS'
Zeigt TMF-Auditlesestatistiken an.
'FILELIST [filter]'
Zeigt die Liste der Tabellen, bei denen Extract Datensätze im Audittrail gefunden hat, die mit den Auswahlkriterien in den TABLE-Parametern übereinstimmen. Mit der Option filter kann ein Platzhaltermuster verwendet werden, um die Liste der zurückgegebenen Tabellen zu filtern. GETFILELIST kann auf die gleiche Weise verwendet werden.
'EXCLUDELIST [filter]'
Zeigt die Liste der Tabellen an, bei denen Extract Datensätze im Audittrail gefunden hat, die nicht mit den Auswahlkriterien in den TABLE-Parametern übereinstimmen. Mit der Option filter kann ein Platzhaltermuster verwendet werden, um die Liste der zurückgegebenen Tabellen zu filtern. Bestimmte Systemtabellen, die implizit ausgeschlossen werden, sind immer in der Liste der ausgeschlossenen Tabellen enthalten.
Der folgende SQL Server-Befehl ist möglich:
VAMMESSAGE 'OPENTRANS'
Gibt eine Liste der offenen Transkationen mit zugehöriger Transaktions-ID, Startzeit, erster LSN und der Anzahl der enthaltenen Vorgänge aus.
Beispiele
SEND EXTRACT exte, ROLLOVER
SEND EXTRACT exte, STOP
SEND EXTRACT exte, VAMMESSAGE 'control:suspend'
SEND EXTRACT exte, TRANLOGOPTIONS TRANSCLEANUPFREQUENCY 20
In diesem Beispiel wird SKIPTRANS erläutert. Die folgende SHOWCH-Ausgabe zeigt, dass Thread 2 sich bei Read Checkpoint #3 befindet.
INFO exte SHOWCH
Read Checkpoint #3
Oracle RAC Redo Log
Startup Checkpoint (starting position in the data source):
Thread #: 2
Sequence #: 17560
RBA: 65070096
Timestamp: 2011-07-30 20:04:47.000000
SCN: 1461.3499051750 (6278446271206)
Redo File: RAC4REDO/sss11g/onlinelog/group_4.292.716481937
Daher sollte SKIPTRANS wie folgt lauten: SKIPTRANS xid THREAD 3.
SEND EXTRACT exte, SHOWTRANS COUNT 2
Das folgende Beispiel zeigt die Standardausgabe von SHOWTRANS.
Oldest redo log file necessary to restart Extract is:
Redo Thread 1, Redo Log Sequence Number 148, SCN 30816254, RBA 17319664
------------------------------------------------------------
XID : 5.15.52582
Items : 30000
Extract : JC108XT
Redo Thread : 1
Start Time : 2011-01-18:12:51:27
SCN : 20634955
Redo Seq : 103
Redo RBA : 18616848
Status : Running
------------------------------------------------------------
XID : 7.14.48657
Items : 30000
Extract : JC108XT
Redo Thread : 1
Start Time : 2011-01-18:12:52:14
SCN : 20635145
Redo Seq : 103
Redo RBA : 26499088
Status : Running
Das folgende Beispiel zeigt die SHOWTRANS-Ausgabe mit TABULAR (Ansicht ist auf der rechten Seite abgeschnitten).
XID Items Extract Redo Thread Start Time
5.15.52582 30000 JC108XT 1 2011-01-18:12:52:14
Dumping transaction memory at 2011-01-21 13:36:54.
Record #1:
Header (140 bytes):
0: 0000 0A4A 0000 FFFF 0000 0000 0057 6C10 ...J.........Wl.
16: 02FF 3F50 FF38 7C40 0303 4141 414E 5A77 ..?P.8|@..AAANZw
32: 4141 4641 4141 4B6F 4941 4144 0041 4141 AAFAAAKoIAAD.AAA
48: 4E5A 7741 4146 4141 414B 6F49 4141 4400 NZwAAFAAAKoIAAD.
64: 4141 414E 5A77 414A 2F41 4142 7A31 7741 AAANZwAJ/AABz1wA
80: 4141 0041 4141 4141 4141 4141 4141 4141 AA.AAAAAAAAAAAAA
96: 4141 4141 4100 0000 0140 FF08 0003 0000 AAAAA....@......
112: 0000 0000 0000 70FF 0108 FFFF 0001 4A53 ......p.......JS
128: 554E 2E54 4355 5354 4D45 5200 UN.TCUSTMER.
Data (93 bytes):
0: 2C00 0400 0400 0000 0100 0200 0300 0000 ,...............
16: 0000 0000 0800 0000 1800 0000 2000 0400 ............ ...
32: 1000 0600 0200 0000 284A 414E 456C 6C6F ........(JANEllo
48: 6352 4F43 4B59 2046 4C59 4552 2049 4E43 cROCKY FLYER INC
64: 2E44 454E 5645 5220 6E43 4F20 7365 7400 .DENVER nCO set.
80: 0000 0000 0000 0C00 0000 0000 00 ..............
Beachten Sie bei der Analyse einer Übersichtsausgabe von SHOWTRANS, dass diese alle derzeit ausgeführten Transaktionen anzeigt (so viele wie in einen vordefinierten Puffer passen). Extract muss jede offene Transaktion verfolgen und nicht nur diejenigen, die Vorgänge in für Oracle GoldenGate konfigurierten Tabellen enthalten.
Das Feld Items der SHOWTRANS-Ausgabe zeigt die Anzahl der bisher von Oracle GoldenGate erfassten Vorgänge in dieser Transaktion und nicht die Gesamtanzahl von Vorgängen in dieser Transaktion an. Wenn keine oder nur einige der Vorgänge für konfigurierte Tabellen gelten, kann Items 0 oder einen anderen Wert enthalten, der kleiner als die Gesamtanzahl an Vorgängen ist.
Das Feld Start Time zeigt den Zeitstempel des ersten Vorgangs an, den Oracle GoldenGate aus einer Transaktion extrahiert, und nicht die tatsächliche Startzeit der Transaktion selbst. Hinweis: Die Befehlsausgabe kann von den gezeigten Beispielen abweichen, da Oracle GoldenGate ständig weiterentwickelt wird.
Das folgende Beispiel zeigt das Senden einer BR-Anforderung an Extract exte
SEND exte BR BRSTATUS
Die Ausgabe zeigt folgende Informationen an:
Bounded Recovery Parameter:
Options = _BRDEBUG _NOBRCLEANUP _BRFORCE_ASSERT
BRINTERVAL = 40SECONDS
BRDIR = /home/mpopeang/ogg_test/
Bounded Recovery Status: IN PROGRESS
Checkpoint interval = 40SECONDS
Next checkpoint = 2020-01-15 21:10:47
Last checkpoint# = 49
Last checkpoint = 2020-01-15 21:10:07
Total objects = 65
Total size = 426 MB
Outstanding objects = 58
Outstanding size = 384 MB
Object pool 1: p12733_extr:RECOVERY: COMPLETE: start:SeqNo: 1580,
RBA: 793460, SCN: 0.664178312(664178312), Timestamp: 2020-01-15 20:35:45.000000,
Thread: 1, end=SeqNo:1580,
RBA: 793460, SCN: 0.664178312 (664178312), Timestamp: 2020-01-15 20:35:45.000000,
Thread: 1, complete=SeqNo: 1580, RBA: 793460,
SCN:0.664178312 (664178312), Timestamp: 2020-01-15 20:35:45.000000, Thread: 1 at 2020-01-15 20:38:52.435830
CHECKPOINT: start=SeqNo: 1637, RBA: 10182312, SCN: 0.669567539 (669567539),
Timestamp: 2020-01-15 21:09:59.000000, Thread: 1, end=SeqNo: 1637,
RBA:10182312, SCN: 0.669567539 (669567539), Timestamp: 2020-01-15 21:09:59.000000,
Thread: 1
Das folgende Beispiel gibt Details zu den einzelnen Objektpools an, die von BR persistiert werden:
SEND exte BR BRSTATS
Ausgabe:
Object pool #0, instance: 1, id: p12733_extr
Objektgrößenwerte während der Lebensdauer der Extract-Gruppe:
Sizes in bytes : POs
512K to 1M-1 : 13
1M to 2M-1 : 37
4M to 8M-1 : 398
8M to 16M-1 : 2
16M to 32M-1 : 10
Objektalterswerte während der Lebensdauer der Extract-Gruppe:
duration: BCP intervals in the life of the PO
duration 0: 230
duration 30 to 39: 230
Bestehende Objektgrößenwerte seit dem letzten BCP:
Sizes in bytes : POs
512K to 1M-1 : 8
1M to 2M-1 : 17
4M to 8M-1 : 200
16M to 32M-1 : 5
Bestehende Objektalterswerte seit dem letzten BCP:
duration: BCP intervals in the life of the PO
duration 30 to 39: 230
Beispiele für die Verwendung von CACHEMGR-Optionen
Gibt alle Cache Manager-Statistiken zurück.
SEND EXTRACT EXT1, CACHEMGR CACHESTATS ALL
Gibt minimale Cache Manager-Statistiken zurück.
SEND EXTRACT EXT1, CACHEMGR CACHESTATS MINIMAL
Gibt Superpool Cache Manager-Statistiken zurück.
SEND EXTRACT EXT1, CACHEMGR CACHESTATS SUPERPOOL
Gibt Cache Manager-Statistiken nur für die aktuelle Laufzeit zurück.
SEND EXTRACT EXT1, CACHEMGR CACHESTATS CURRENTONLY
Gibt Statistiken für alle Objektpools zurück.
SEND EXTRACT EXT1, CACHEMGR CACHESTATS POOLS
Gibt nur Statistiken für den angegebenen Objektpool zurück. Ersetzen Sie n durch die Objektpoolnummer.
SEND EXTRACT EXT1, CACHEMGR CACHESTATS POOL n
Beispiel: Gibt nur Statistiken für Objektpool 1 zurück.
SEND EXTRACT EXT1, CACHEMGR CACHESTATS POOL 1
Gibt Statistiken für Queues zurück.
SEND EXTRACT EXT1, CACHEMGR CACHESTATS QUEUES
Gibt Statistiken zur freien Cache Manager-Queue zurück.
SEND EXTRACT EXT1, CACHEMGR CACHEQUEUES
Gibt Statistiken zur virtuellen Cache-Speicherauslastung zurück.
SEND EXTRACT EXT1, CACHEMGR CACHEVMUSAGE