GET_STATISTICS

Durée de validité

Extraction et réplication

Description

Utilisez la fonction GET_STATISTICS pour extraire les statistiques de traitement en cours pour le processus d'extraction ou de réplication. Par exemple, l'exit utilisateur peut générer des statistiques dans un rapport personnalisé en cas d'erreur fatale lors du traitement d'extraction ou de réplication.

Les statistiques sont gérées automatiquement en fonction du type de processus qui a demandé les données :

• Le traitement Extract traite toujours la demande comme une table source, en comptant cette table une seule fois, quel que soit le nombre de fois où la sortie est générée.

• Le processus Replicat traite toujours la demande comme un ensemble de tables cible. L'ensemble inclut tous les décomptes sur la cible, quel que soit le nombre de tables source.

Si la base de données fait la distinction entre les majuscules et les minuscules, les noms d'objet doivent être indiqués dans la même casse que celle définie dans la base de données d'hébergement. Sinon, la casse n'a pas d'importance.

Syntaxe

#include "usrdecs.h"
short result_code;
statistics_def statistics;
ERCALLBACK (GET_STATISTICS, &statistics, &result_code);

Tampon

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;

Entrée

<table_name>

Chaîne à terminaison NULL indiquant le nom qualifié complet de la table source. Les statistiques sont toujours enregistrées par rapport aux enregistrements source. Si la session de caractères de l'exit utilisateur est définie avec SET_SESSION_CHARSET sur une valeur autre que le jeu de caractères par défaut du système d'exploitation, tel que défini dans ULIB_CS_DEFAULT dans le fichier ucharset.h, le nom de la table et la date sont interprétés dans le jeu de caractères de session.

<group>

Il peut s'agir de l'une des valeurs suivantes :

EXIT_STAT_GROUP_STARTUP

Extrait les statistiques depuis le dernier démarrage du processus Oracle GoldenGate.

EXIT_STAT_GROUP_DAILY

Extrait les statistiques depuis minuit du jour en cours.

EXIT_STAT_GROUP_HOURLY

Extrait les statistiques depuis le début de l'heure en cours.

EXIT_STAT_GROUP_RECENT

Extrait les statistiques depuis leur réinitialisation à l'aide de GGSCI.

EXIT_STAT_GROUP_REPORT

Extrait les statistiques depuis la génération du dernier rapport.

EXIT_STAT_GROUP_USEREXIT

Extrait les statistiques depuis la dernière réinitialisation des statistiques par l'exit utilisateur avec RESET_USEREXIT_STATS.

Sortie

start_datetime

Chaîne à terminaison NULL au format YYYY-MM-DD HH:MI:SS indiquant la date et l'heure locales auxquelles les statistiques ont commencé à être enregistrées pour le groupe indiqué.

<num_inserts>

Nombre d'insertions renvoyées traitées par le processus Extract ou Replicat.

<num_updates>

Nombre de mises à jour renvoyées traitées par le processus Extract ou Replicat.

<num_befores>

Nombre de mises à jour renvoyées avant le traitement des images par le processus d'extraction ou de réplication.

<num_deletes>

Nombre de suppressions renvoyées traitées par le processus Extract ou Replicat.

<num_discards>

Nombre d'enregistrements renvoyés rejetés par l'extraction ou la réplication.

<num_ignores>

Nombre d'enregistrements renvoyés ignorés par le processus Extract ou Replicat.

<total_db_operations>

Nombre total d'opérations de base de données renvoyées traitées par le processus Extract ou Replicat.

<total_operations>

Nombre total d'opérations renvoyées traitées par le processus Extract ou Replicat, y compris les rejets et les ignorations.

<num_truncates>

Nombre renvoyé de tronçons traités par le processus Extract ou Replicat.

Valeurs retournées

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_TABLE_NOT_FOUND
EXIT_FN_RET_OK