GET_STATISTICS

有效对象

提取和复制

说明

使用 GET_STATISTICS 函数检索提取或复制进程的当前处理统计信息。例如，如果在提取或复制处理期间发生致命错误，用户出口可以将统计信息输出到定制报表。

系统会根据请求数据的处理类型自动处理统计信息：

• “提取”处理将始终将请求视为源表，计算该表一次，而不考虑输出的次数。

• 复制处理将始终将请求视为一组目标表。该集包括目标的所有计数，而不考虑源表的数量。

如果数据库区分大小写，则必须使用与托管数据库中定义的对象名称相同的字母大小写指定对象名称；否则，大小写无关紧要。

语法

#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 格式结尾的空字符串，指示开始为指定组记录统计信息的本地日期和时间。

<num_inserts>

提取或复制处理的返回的插入数。

<num_updates>

提取或复制处理的返回的更新数。

<num_befores>

提取或复制处理的图像之前返回的更新数。

<num_deletes>

提取或复制处理的返回删除数。

<num_discards>

提取或复制丢弃的返回记录数。

<num_ignores>

提取或复制忽略的返回记录数。

<total_db_operations>

提取或复制处理的数据库操作总数的返回数。

<total_operations>

提取或复制处理的返回操作总数，包括放弃和忽略。

<num_truncates>

提取或复制处理的返回截断数。

返回值

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_TABLE_NOT_FOUND
EXIT_FN_RET_OK