GET_STATISTICS
Valido per
Estrai e Replicat
Descrizione
Utilizzare la funzione GET_STATISTICS per recuperare le statistiche di elaborazione correnti per il processo Extract o Replicat. Ad esempio, l'uscita utente può generare statistiche in un report personalizzato se si verifica un errore irreversibile durante l'elaborazione Extract o Replicat.
Le statistiche vengono gestite automaticamente in base al tipo di processo che ha richiesto i dati:
-
Il processo Extract considera sempre la richiesta come una tabella di origine, contando tale tabella una volta, indipendentemente dal numero di volte in cui viene generato l'output.
-
Il processo Replicat considererà sempre la richiesta come un set di tabelle di destinazione. Il set include tutti i conteggi nella destinazione indipendentemente dal numero di tabelle di origine.
Se il database fa distinzione tra maiuscole e minuscole, i nomi degli oggetti devono essere specificati nella stessa lettera maiuscola definita nel database di hosting; in caso contrario, il caso non importa.
Sintassi
#include "usrdecs.h"
short result_code;
statistics_def statistics;
ERCALLBACK (GET_STATISTICS, &statistics, &result_code);
Buffer
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;
Input
<table_name>
Stringa con terminazione nulla che specifica il nome completamente qualificato della tabella di origine. Le statistiche vengono sempre registrate rispetto ai record di origine. Se la sessione di caratteri dell'uscita utente viene impostata con SET_SESSION_CHARSET su un valore diverso dal set di caratteri predefinito del sistema operativo, come definito in ULIB_CS_DEFAULT nel file ucharset.h, il nome della tabella e la data vengono interpretati nel set di caratteri della sessione.
<group>
Può essere uno dei nomi riportati di seguito.
EXIT_STAT_GROUP_STARTUP
Recupera le statistiche dall'ultimo avvio del processo Oracle GoldenGate.
EXIT_STAT_GROUP_DAILY
Recupera le statistiche dalla mezzanotte del giorno corrente.
EXIT_STAT_GROUP_HOURLY
Recupera le statistiche dall'inizio dell'ora corrente.
EXIT_STAT_GROUP_RECENT
Recupera le statistiche poiché le statistiche sono state reimpostate utilizzando GGSCI.
EXIT_STAT_GROUP_REPORT
Recupera le statistiche dall'ultima generazione del report.
EXIT_STAT_GROUP_USEREXIT
Recupera le statistiche dall'ultima volta che l'utente esce reimposta le statistiche con RESET_USEREXIT_STATS.
Output
start_datetime
Stringa con terminazione nulla nel formato YYYY-MM-DD HH:MI:SS che indica la data e l'ora locali in cui le statistiche hanno iniziato a essere registrate per il gruppo specificato.
<num_inserts>
Numero restituito di inserimenti elaborati da Extract o Replicat.
<num_updates>
Il numero restituito di aggiornamenti elaborati da Extract o Replicat.
<num_befores>
Numero di aggiornamenti restituito prima dell'elaborazione delle immagini da parte di Extract o Replicat.
<num_deletes>
Il numero restituito di eliminazioni elaborate da Extract o Replicat.
<num_discards>
Il numero restituito di record eliminati da Extract o Replicat.
<num_ignores>
Il numero restituito di record ignorati da Extract o Replicat.
<total_db_operations>
Numero restituito di operazioni di database totali elaborate da Extract o Replicat.
<total_operations>
Numero restituito di operazioni totali elaborate da Extract o Replicat, inclusi gli scarti e gli ignoramenti.
<num_truncates>
Il numero restituito di tronchi elaborati da Extract o Replicat.
Valori restituiti
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_TABLE_NOT_FOUND
EXIT_FN_RET_OK