GET_STATISTICS

有効な対象

ExtractおよびReplicat

摘要

GET_STATISTICSファンクションでは、ExtractまたはReplicatプロセスの現在の処理統計を取得します。たとえばユーザー・イグジットは、ExtractまたはReplicat処理中に致命的なエラーが発生した場合に、カスタム・レポートに統計を出力できます。

統計は、データをリクエストしたプロセスのタイプに基づいて自動的に処理されます。

Extractプロセスは、常にリクエストをソース表として扱い、出力回数にかかわらずこの表を1回カウントします。
Replicatプロセスは、常にリクエストをターゲット表のセットとして扱います。このセットには、ソース表の数にかかわらず、ターゲットへのすべてのカウントが含まれます。

データベースが大/小文字を区別する場合、オブジェクト名は、ホストしているデータベースで定義されているものと同じ大/小文字の識別で指定する必要があります。それ以外の場合は、大/小文字は区別されません。

構文

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

バッファ

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;

入力

<table_name>

ソース表の完全修飾名を指定するNULL終了文字列。統計は常にソース・レコードに対して記録されます。ユーザー・イグジットの文字セッションが、SET_SESSION_CHARSETを使用して、オペレーティング・システムのデフォルトの文字セット以外の値に設定されている場合、ucharset.hファイルのULIB_CS_DEFAULTで定義されているように、表名および日付はセッションの文字セットで解釈されます。

<group>

次のいずれかです:

EXIT_STAT_GROUP_STARTUP

Oracle GoldenGateプロセスが最後に起動したときからの統計を取得します。

EXIT_STAT_GROUP_DAILY

現在の日付の午前0時からの統計を取得します。

EXIT_STAT_GROUP_HOURLY

現在の時間の開始からの統計を取得します。

EXIT_STAT_GROUP_RECENT

GGSCIを使用して統計をリセットしてからの統計を取得します。

EXIT_STAT_GROUP_REPORT

最後のレポートが生成されてからの統計を取得します。

EXIT_STAT_GROUP_USEREXIT

ユーザー・イグジットがRESET_USEREXIT_STATSを使用して最後に統計をリセットしてからの統計を取得します。

出力

start_datetime

指定のグループに対して統計の記録が開始されたローカルの日付と時刻を示すYYYY-MM-DD HH:MI:SSフォーマットのNULL終了文字列。

<num_inserts>

返されるExtractまたはReplicatが処理した挿入数。

<num_updates>

返されるExtractまたはReplicatが処理した更新数。

<num_befores>

返されるExtractまたはReplicatが処理した更新のビフォア・イメージ数。

<num_deletes>

返されるExtractまたはReplicatが処理した削除数。

<num_discards>

返されるExtractまたはReplicatが破棄したレコード数。

<num_ignores>

返されるExtractまたはReplicatが無視したレコード数。

<total_db_operations>

返されるExtractまたはReplicatが処理したデータベース操作合計数。

<total_operations>

返されるExtractまたはReplicatが処理した合計操作数(破棄および無視を含む)。

<num_truncates>

返されるExtractまたはReplicatが処理した切捨て数。

戻り値

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_TABLE_NOT_FOUND
EXIT_FN_RET_OK