6.36 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

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

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