GET_STATISTICS
유효 기간
추출 및 복제
설명
GET_STATISTICS 함수를 사용하여 Extract 또는 Replicat 프로세스에 대한 현재 처리 통계를 검색합니다. 예를 들어, User Exit은 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>
소스 테이블의 전체 이름을 지정하는 널 종료 문자열입니다. 통계는 항상 소스 레코드에 대해 기록됩니다. User Exit의 문자 세션이 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
User Exit이 RESET_USEREXIT_STATS를 사용하여 통계를 마지막으로 재설정한 이후의 통계를 검색합니다.
출력
start_datetime
지정된 그룹에 대한 통계가 기록되기 시작한 로컬 날짜 및 시간을 나타내는 YYYY-MM-DD HH:MI:SS 형식의 널 종료 문자열입니다.
<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