GET_STATISTICS
Válido Para
Extract e Replicat
Descrição
Use a função GET_STATISTICS para recuperar as estatísticas de processamento atuais do processo Extract ou Replicat. Por exemplo, a saída do usuário poderá gerar estatísticas para um relatório personalizado caso ocorra um erro fatal durante o processamento Extract ou Replicat.
As estatísticas são tratadas automaticamente com base em qual tipo de processo solicitou os dados:
-
O processo Extract sempre tratará a solicitação como uma tabela de origem, contando essa tabela uma vez, independentemente do número de vezes que a saída é feita.
-
O processo Replicat sempre tratará a solicitação como um conjunto de tabelas de destino. O conjunto inclui todas as contagens para o destino, independentemente do número de tabelas de origem.
Se o banco de dados fizer distinção entre maiúsculas e minúsculas, os nomes de objetos devem ser especificados na mesma letra que são definidos no banco de dados de hospedagem; caso contrário, a letra não importa.
Sintaxe
#include "usrdecs.h"
short result_code;
statistics_def statistics;
ERCALLBACK (GET_STATISTICS, &statistics, &result_code);Buffer
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;Entrada
<table_name>
Uma string terminada com valor nulo que especifica o nome totalmente qualificado da tabela de origem. As estatísticas são sempre registradas nos registros de origem. Se a sessão de caracteres da saída do usuário for definida com SET_SESSION_CHARSET para um valor diferente do conjunto de caracteres padrão do sistema operacional, conforme definido em ULIB_CS_DEFAULT no arquivo ucharset.h, o nome da tabela e a data serão interpretados no conjunto de caracteres da sessão.
<group>
Pode ser um dos seguintes:
EXIT_STAT_GROUP_STARTUP
Recupera estatísticas desde o último início do processo do Oracle GoldenGate.
EXIT_STAT_GROUP_DAILY
Recupera estatísticas desde a meia-noite do dia atual.
EXIT_STAT_GROUP_HOURLY
Recupera estatísticas desde o início da hora atual.
EXIT_STAT_GROUP_RECENT
Recupera estatísticas desde que as estatísticas foram redefinidas usando GGSCI.
EXIT_STAT_GROUP_REPORT
Recupera estatísticas desde que o último relatório foi gerado.
EXIT_STAT_GROUP_USEREXIT
Recupera estatísticas desde a última vez que a saída do usuário redefine as estatísticas com RESET_USEREXIT_STATS.
Saída
start_datetime
Uma string terminada com valor nulo no formato YYYY-MM-DD HH:MI:SS indicando a data e a hora locais em que as estatísticas começaram a ser registradas para o grupo especificado.
<num_inserts>
O número retornado de inserções processadas pelo processo Extract ou Replicat.
<num_updates>
O número retornado de atualizações processadas pelo Extract ou Replicat.
<num_befores>
O número retornado de atualizações antes das imagens processadas pelo Extract ou Replicat.
<num_deletes>
O número retornado de exclusões processadas pelo Extract ou Replicat.
<num_discards>
O número retornado de registros descartados pelo processo Extract ou Replicat.
<num_ignores>
O número retornado de registros ignorados por Extract ou Replicat.
<total_db_operations>
O número retornado do total de operações do banco de dados processadas pelo Extract ou Replicat.
<total_operations>
O número retornado do total de operações processadas pelo Extract ou Replicat, incluindo descartes e ignorações.
<num_truncates>
O número retornado de truncamentos processados por Extract ou Replicat.
Valores de Retorno
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_TABLE_NOT_FOUND
EXIT_FN_RET_OK