GET_STATISTICS

有效對象

擷取與 Replicat

說明

使用 GET_STATISTICS 函數來擷取 Extract 或 Replicat 處理作業目前的處理統計資料。例如，使用者出口程式可在 Extract 或 Replicat 處理期間發生嚴重錯誤時，將統計資料輸出至自訂報表。

統計資料會根據要求資料的處理類型自動處理：

• 「摘錄」處理程序一律會將要求視為來源表，不論輸出的次數為何，都會計算一次該表。

• 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>

指定來源表格完整名稱的空值終止字串。系統一律會記錄來源記錄統計資料。如果使用者結束程式的字元階段作業使用 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 的空值終止字串，指示開始為指定群組記錄統計資料的本機日期與時間。

<num_inserts>

Extract 或 Replicat 所處理的傳回插入數目。

<num_updates>

Extract 或 Replicat 所處理的傳回更新數目。

<num_befores>

擷取或 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