GET_STATISTICS
Gültig für
Extrakt und Replicat
Beschreibung
Verwenden Sie die Funktion GET_STATISTICS, um die aktuellen Verarbeitungsstatistiken für den Extract- oder Replicat-Prozess abzurufen. Beispiel: Der User Exit kann Statistiken an einen benutzerdefinierten Bericht ausgeben, wenn während der Extract- oder Replicat-Verarbeitung ein schwerwiegender Fehler auftritt.
Statistiken werden automatisch basierend darauf verarbeitet, welcher Prozesstyp die Daten angefordert hat:
-
Der Extraktionsprozess behandelt die Anforderung immer als Quelltabelle, wobei diese Tabelle unabhängig von der Häufigkeit der Ausgabe einmal gezählt wird.
-
Der Replicat-Prozess behandelt die Anforderung immer als Gruppe von Zieltabellen. Das Set enthält alle Zählungen für das Ziel, unabhängig von der Anzahl der Quelltabellen.
Wenn bei der Datenbank die Groß-/Kleinschreibung beachtet wird, müssen Objektnamen in derselben Groß-/Kleinschreibung angegeben werden, wie sie in der Hostdatenbank definiert sind. Andernfalls spielt die Groß-/Kleinschreibung keine Rolle.
Syntax
#include "usrdecs.h"
short result_code;
statistics_def statistics;
ERCALLBACK (GET_STATISTICS, &statistics, &result_code);Puffer
typedef struct
{
char *table_name;
short group;
exit_timestamp_string start_datetime;
long num_inserts;
long num_updates;
long num_befores;
long num_deletes;
long num_discards;
long num_ignores;
long total_db_operations;
long total_operations;
/* Version 2 CALLBACK_STRUCT_VERSION */
long num_truncates;
} statistics_def;Eingabe
<table_name>
Eine nullbeendete Zeichenfolge, die den vollqualifizierten Namen der Quelltabelle angibt. Statistiken werden immer für die Quelldatensätze aufgezeichnet. Wenn die Zeichensession des User Exit mit SET_SESSION_CHARSET auf einen anderen Wert als den Standardzeichensatz des Betriebssystems gesetzt wird, wie in ULIB_CS_DEFAULT in der Datei ucharset.h definiert, werden der Tabellenname und das Datum im Sessionzeichensatz interpretiert.
<group>
Einer der folgenden Namen kann verwendet werden:
EXIT_STAT_GROUP_STARTUP
Ruft Statistiken ab, seit der Oracle GoldenGate-Prozess zuletzt gestartet wurde.
EXIT_STAT_GROUP_DAILY
Ruft Statistiken seit Mitternacht des aktuellen Tages ab.
EXIT_STAT_GROUP_HOURLY
Ruft Statistiken seit dem Beginn der aktuellen Stunde ab.
EXIT_STAT_GROUP_RECENT
Ruft Statistiken ab, seit die Statistiken mit GGSCI zurückgesetzt wurden.
EXIT_STAT_GROUP_REPORT
Ruft Statistiken ab, seit der letzte Bericht generiert wurde.
EXIT_STAT_GROUP_USEREXIT
Ruft Statistiken ab, die seit dem letzten Beenden des Benutzers die Statistiken mit RESET_USEREXIT_STATS zurückgesetzt haben.
Ausgabe
start_datetime
Eine nullbeendete Zeichenfolge im Format YYYY-MM-DD HH:MI:SS, die das lokale Datum und die lokale Uhrzeit angibt, zu der Statistiken für die angegebene Gruppe aufgezeichnet wurden.
<num_inserts>
Die zurückgegebene Anzahl von Einfügungen, die von Extract oder Replicat verarbeitet wurden.
<num_updates>
Die zurückgegebene Anzahl von Aktualisierungen, die von Extract oder Replicat verarbeitet wurden.
<num_befores>
Die zurückgegebene Anzahl von Aktualisierungen vor Bildern, die von Extract oder Replicat verarbeitet wurden.
<num_deletes>
Die zurückgegebene Anzahl von Löschvorgängen, die von Extract oder Replicat verarbeitet wurden.
<num_discards>
Die zurückgegebene Anzahl von Datensätzen, die von Extract oder Replicat verworfen wurden.
<num_ignores>
Die zurückgegebene Anzahl von Datensätzen, die von Extract oder Replicat ignoriert wurden.
<total_db_operations>
Die zurückgegebene Anzahl der gesamten Datenbankvorgänge, die von Extract oder Replicat verarbeitet wurden.
<total_operations>
Die zurückgegebene Anzahl der gesamten Vorgänge, die von Extract oder Replicat verarbeitet wurden, einschließlich Verwerfen und Ignorieren.
<num_truncates>
Die zurückgegebene Anzahl von Truncates, die von Extract oder Replicat verarbeitet wurden.
Rückgabewerte
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_TABLE_NOT_FOUND
EXIT_FN_RET_OK