SEND REPLICAT

Use SEND REPLICAT para se comunicar com um processo de Replicat inicial ou em execução. A solicitação é processada logo que o Replicat está pronto para aceitar comandos de usuários.

Sintaxe

SEND REPLICAT group_name[threadID],
{
CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE} |
DEPENDENCYINFO [TXNCOUNT num] |
FORCESTOP |
GETLAG |
GETPARAMINFO [parameter_name] [FILE output_file] |
HANDLECOLLISIONS | NOHANDLECOLLISIONS [table_spec] |
INTEGRATEDPARAMS(parameter_specification) |
LOGEND |
REPORT [HANDLECOLLISIONS [table_spec]] |
RESUME |
STATUS |
STOP |
TRACE[2] [DDLINCLUDE | DDL[ONLY]] file_name |
TRACE[2] OFF |
TRACE OFF file_name |
TRACEINIT |
THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])
}

group_name[threadID]

O nome do grupo de Replicat ou o nome de um thread específico de um Replicat coordenado, por exemplo fin003. Se o comando for emitido para um thread específico, uma opção que for usada se aplicará apenas a esse thread. Como alternativa, você pode emitir SEND REPLICAT com a opção THREADS em vez de incluir threadID com o nome do grupo. Se o Replicat não estiver em execução, um erro será retornado.

CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE}

Retorna estatísticas sobre o gerenciador do cache de memória do Oracle GoldenGate. CACHEMGR só deve ser usado conforme instruído explicitamente pelo Suporte Técnico da Oracle.

CACHESTATS

Retorna estatísticas para armazenamento de arquivos em cache.

CACHEQUEUES

Só retorna estatísticas das filas livres.

CACHEVMUSAGE

Retorna estatísticas para o uso da memória virtual.

DEPENDENCYINFO [TXNCOUNT num]

Imprime informações do gráfico de dependência da transação PR. Primeiro, ele imprime os grupos de transações que estão sendo executados no momento e, em seguida, as transações em espera que dependem de algumas outras transações. TXNCOUNT determina o número de transações em espera a serem impressas. O valor padrão é 10, e o valor máximo é 99.

FORCESTOP

Força o Replicat a parar, ignorando quaisquer notificações. Esse comando fará rollback de qualquer transação ativa e interromperá o processo imediatamente. Esse comando se aplica ao Replicat como um todo e não pode ser usado para um thread específico do Replicat.

GETLAG

Mostra um tempo de atraso verdadeiro entre o Replicat e a trilha. Para o Replicat, o intervalo é a diferença, em segundos, entre o horário em que o último registro foi processado pelo Replicat e o timestamp desse registro na trilha. Os resultados são iguais aos de LAG REPLICAT.

GETPARAMINFO [parameter_name] [FILE output_file]

Use GETPARAMINFO para consultar valores de parâmetro de runtime de uma instância em execução, incluindo Extract, Replicat e Manager. Você pode consultar um único parâmetro ou todos e enviar a saída para a console ou para um arquivo de texto

parameter_name

O comportamento padrão é exibir todos os parâmetros em uso, o que significa aqueles que já foram consultados pelo aplicativo, outros parâmetros e seus valores atuais. Se você especificar um determinado parâmetro, a saída será filtrada por esse nome.

FILE output_file

O nome do arquivo de texto para o qual a saída é redirecionada.

HANDLECOLLISIONS NOHANDLECOLLISIONS [table_spec]

Controle o comportamento do HANDLECOLLISIONS. Em vez de usar essa opção, você pode especificar o parâmetro HANDLECOLLISIONS ou NOHANDLECOLLISIONS no arquivo de parâmetros de Replicat. Consulte HANDLECOLLISIONS \| NOHANDLECOLLISIONS na Referência de Parâmetros e Funções do Oracle GoldenGate. Esse comando pode ser enviado diretamente a um thread individual por meio de SEND REPLICAT group_name[threadID] ou você pode usar a opção THREADS para enviar o comando por meio do thread do coordenador para afetar vários threads.

HANDLECOLLISIONS

Use HANDLECOLLISIONS para ativar o tratamento automático de erros ao executar carregamentos de dados iniciais enquanto o banco de dados de origem estiver ativo. Certifique-se de desativar HANDLECOLLISIONS, emitindo SEND REPLICAT com a opção NOHANDLECOLLISIONS ou removendo o parâmetro do arquivo de parâmetro, após a conclusão da carga inicial e as alterações de dados on-line terem sido aplicadas às tabelas de destino. Observação: A mensagem retornada por `SEND

                                            REPLICAT` with `HANDLECOLLISIONS`, when issued for a specific Replicat thread, shows that the command set `HANDLECOLLISIONS` for all `MAP` statements, not only the one handled by the specified thread. This is a known issue. The command actually affects only the `MAP` statement that includes the specified thread.
                                            {: .infoboxnote}

NOHANDLECOLLISIONS

Desativa o parâmetro HANDLECOLLISIONS, mas não o remove do arquivo do parâmetro. Para evitar ativar HANDLECOLLISIONS na próxima vez que a Replicação for iniciada, remova-a do arquivo do parâmetro.

table_spec

table_spec restringe HANDLECOLLISIONS ou NOHANDLECOLLISIONSa uma tabela ou grupo de tabelas de destino específico especificado com um caractere curinga padrão (*).

INTEGRATEDPARAMS(parameter_specification)

(Oracle) Suporta um Replicat integrado. Envia uma especificação de parâmetro ao servidor de entrada do banco de dados enquanto o Replicat está em execução no modo integrado. Somente uma especificação de parâmetro pode ser enviada por vez com esse comando. Para enviar várias alterações de parâmetro, emita vários comandos SEND REPLICAT, como no exemplo a seguir.

SEND REPLICAT repe INTEGRATEDPARAMS (parallelism 4)
SEND REPLICAT repe INTEGRATEDPARAMS (max_sga_size 250)

Para preservar a continuidade do processamento, a alteração de parâmetro é feita em um limite de transação.

LOGEND

Confirma se o Replicat processou ou não todos os registros na origem de dados.

REPORT [HANDLECOLLISIONS [table_spec]]

Gera um relatório estatístico provisório para o arquivo de relatório do Extract. As estatísticas exibidas dependem da configuração do parâmetro STATOPTIONS quando usado com a opção RESETREPORTSTATS | NORESETREPORTSTATS. Consulte STATOPTIONS.

HANDLECOLLISIONS

Mostra tabelas para as quais o HANDLECOLLISIONS foi ativado.

table spec

Restringe a saída a uma tabela de destino específica ou a um grupo de tabelas de destino especificadas com um caractere curinga (*) padrão.

RESUME

Reinicia (ativa) um processo que foi suspenso por um evento EVENTACTIONS SUSPEND. O processo retoma o processamento normal do ponto em que foi suspenso.

STATUS

Retorna a localização atual dentro da trilha e informações relativas à transação atual. A saída dos campos é como se segue:

Status do processamento (por thread, se o Replicat for coordenado)
Posição no arquivo de trilha (por thread, se o Replicat for coordenado)
Número de sequência de trilha (por thread, se o Replicat for coordenado)
RBA na trilha
Nome da trilha

As possíveis mensagens de status de processamento são as seguintes:

Delaying – aguardando mais dados
Suspended – aguardando para ser retomado
Waiting on deferred apply – atrasando o processamento com base no parâmetro DEFERAPPLYINTERVAL.
Processing data – processando dados
Skipping current transaction – Foi usado o START REPLICAT com SKIPTRANSACTION.
Searching for START ATCSN csn – Foi usado o START REPLICAT com ATCSN.
Searching for START AFTERCSN csn – Foi usado o START REPLICAT com AFTERCSN.
Performing transaction timeout recovery – Cancelando a transação incompleta atual e reposicionando para iniciar uma nova (consulte o parâmetro TRANSACTIONTIMEOUT).
Waiting for data at logical EOF after transaction timeout recovery – Aguardando para receber o restante da transação da origem incompleta após uma finalização de TRANSACTIONTIMEOUT.
At EOF (end of file) – não há mais registros a serem processados

As possíveis mensagens de status de thread quando o THREADS for usado ou o comando for emitido para um thread específico são:

Waiting for consensus stop point: Indica que os threads estão tentando sincronizar para uma transação de barreira.
Waiting for Watermark: Indica que todos os threads estão tentando interromper no mesmo limite da transação na trilha, conhecida como marca d'água global.
Waiting on all threads to start up: Indica que o thread está aguardando a inicialização de todos os threads após uma transação de barreira bem-sucedida ou uma inicialização de Replicat.

As possíveis mensagens de status do thread coordenador são as seguintes:

Waiting for all threads to register: Indica que todas as instruções MAP estão sendo analisadas para determinar os IDs de thread especificados nelas.
Processing data: Indica que dados estão sendo processados normalmente.
Suspended, waiting to be resumed: Indica que um comando SEND REPLICAT com uma solicitação SUSPEND foi enviado para Replicat.
At EOF: Indica que não há mais dados na trilha a ser processada.
Waiting to register MAP statistics: Indica que a Replicação está coletando estatísticas de processamento para enviar ao arquivo de relatório.

STOP

Interrompe o Replicat normalmente. Esse comando se aplica ao Replicat como um todo e não pode ser usado para um thread específico do Replicat.

THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])

Emite o comando somente para o thread ou threads especificados de um Replicat coordenado. Você pode usar essa opção ou usar o groupname com o threadID. Sem uma dessas opções, o comando se aplica a todos os threads ativos.

threadID[, threadID][, ...]

Especifica um ID do thread ou uma lista de threads delimitada por vírgulas no formato threadID, threadID, threadID.

thread_range[, thread_range][, ...]

Especifica uma faixa de threads na forma de threadIDlow-threadIDhigh ou uma lista de faixas delimitada por vírgulas no formato de threadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Uma combinação desses formatos é permitida, como threadID, threadID, threadIDlow-threadIDhigh.

TRACE[2] [DDLINCLUDE DDL[ONLY]] file_name

Ativa e desativa o rastreamento. O rastreamento captura informações no arquivo especificado para revelar gargalos no processamento. O rastreamento também pode ser ativado por meio dos parâmetros TRACE e TRACE2 do Replicat.

Se o Replicat estiver no modo coordenado e TRACE for usado com uma lista ou faixa THREADS, será criado um arquivo do rastreamento para cada thread ativo no momento. Cada nome de arquivo recebe seu ID de thread associado. Este método de identificação de arquivo de rastreamento por ID de thread não se aplica quando SEND REPLICAT é emitido por groupname com threadID (como em SEND REPLICAT fin003 TRACE…) ou quando somente um thread é especificado por THREADS.

Entre em contato com o Suporte Técnico da Oracle para obter assistência se o rastreamento revelar significativos gargalos no processamento.

TRACE

Captura informações de processamento etapa por etapa.

TRACE2

Identifica segmentos de código em vez de etapas específicas.

DDLINCLUDE | DDLONLY

(Apenas Replicat) Permite o rastreamento de DDL e especifica como o rastreamento de DDL é incluído no relatório de rastreamento.

DDLINCLUDE inclui rastreamento de DDL, além de rastreamento regular de processamento transacional de dados.
DDL[ONLY] exclui o rastreamento de processamento de dados transacionais e somente rastreia DDL. Esta opção pode ser abreviada para DDL.

file_name

file_name especifica o nome relativo ou totalmente qualificado de um arquivo para o qual o Oracle GoldenGate registra as informações de rastreamento. Se um rastreamento já estiver em andamento, o arquivo do rastreamento existente estará fechado e o rastreamento será retomado no arquivo especificado com file_name. Por exemplo:

SEND REPLICAT group_name TRACE file_name DDLINCLUDE

Se nenhuma outra opção seguir o nome do arquivo, a palavra-chave FILE poderá ser omitida, por exemplo:

SEND REPLICAT group_name TRACE DDLINCLUDE file_name

TRACE[2] OFF

Desativa o rastreamento.

TRACE OFF file_name

Desativa o rastreamento apenas para o arquivo de rastreamento especificado. Esta opção suporta a funcionalidade EVENTACTIONS, na qual pode haver vários arquivos do rastreamento em decorrência de várias instruções EVENTACTIONS.

TRACEINIT

Redefine as estatísticas de rastreamento de volta para 0 e, em seguida, começa a acumular estatísticas novamente. Use essa opção para rastrear o comportamento atual de processamento, em vez do histórico.

Exemplos

SEND REPLICAT repe, HANDLECOLLISIONS

SEND REPLICAT repe, REPORT HANDLECOLLISIONS rep_*

SEND REPLICAT repe, GETLAG

SEND REPLICAT repe, INTEGRATEDPARAMS(parallelism 10)

A opção a seguir obtém um atraso para o thread 3 de um Replicat coordenado.

SEND REPLICAT repe, GETLAG

A opção a seguir ativa o rastreamento somente para o thread 1 de um Replicat coordenado. Nesse caso, como apenas um thread está sendo rastreado, o arquivo de rastreamento não terá uma extensão threadID. O nome do arquivo é trace.trc.

SEND REPLICAT repe, TRACE THREADS(1) FILE ./dirrpt/trace.trc

A opção a seguir ativa o rastreamento para os threads 1, 2 e 3 de um Replicat coordenado. Supondo que todos os threads estejam ativos, o rastreamento produzirá os arquivos trace001, trace002 e trace003.

SEND REPLICAT repe TRACE THREADS(1-3) FILE ./dirrpt/trace.trc

A opção a seguir ativa o rastreamento somente para o thread 1 de um Replicat coordenado. Como o comando foi emitido diretamente para a thread 1 sem o uso de uma cláusula THREAD, o arquivo do rastreamento é chamado trace (sem um sufixo do ID do thread).

SEND REPLICAT repe TRACE FILE ./dirrpt/trace.trc