ADD REPLICAT

Use ADD REPLICAT para criar um grupo de Replicat. Esse comando cria um grupo de processo on-line que cria pontos de verificação para que seja mantida a continuidade do processamento da execução para execução. Não pode exceder 500 bytes de tamanho para todas as palavras-chave e entrada, incluindo qualquer texto que você informar para a opção DESC.

O Oracle GoldenGate suporta até 5.000 grupos Extract e Replicat simultâneos por instância do Oracle GoldenGate Service Manager. No nível suportado, todos os grupos podem ser controlados e exibidos na íntegra usando comandos como os comandos INFO e STATUS.

O Oracle GoldenGate recomenda manter o número de grupos Extract e Replicat (combinados) no nível padrão de 300 ou abaixo, com o objetivo de gerenciar o ambiente de maneira eficiente.

(Oracle) A menos que a opção INTEGRATED seja usada, esse comando cria um grupo de Replicat no modo não integrado.

Sintaxe

ADD REPLICAT group_name
[, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
{, EXTTRAIL trail_name}
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, EXTRBA rba]
{, CHECKPOINTTABLE owner.table}
[, DESC 'description']
[, ENCRYPTIONPROFILE encryption-profile-name ]
                [ CRITICAL        [ YES | NO ]  ]
                [ PROFILE          profile-name
[ AUTOSTART
                [ YES | NO ]
                [ DELAY delay-number ] ]
                [ AUTORESTART [ YES | NO ]
                [ RETRIES      retries-number ]
                [ WAITSECONDS  wait-number    ]
                [ RESETSECONDS reset-number   ]
                [ DISABLEONFAILURE [ YES | NO ]     ] ] ]

group_name

O nome do grupo Replicat. Se você não especificar qualquer opção, será criado um Replicat clássico. O nome de um grupo Replicat coordenado e paralelo pode conter no máximo cinco caracteres. O nome de um grupo Replicat regular pode conter até oito caracteres.

INTEGRATED

(Oracle) Cria o Replicat no modo integrado. Sem essa opção, ADD REPLICAT cria o processo Replicat no modo não integrado (clássico). Essa opção funciona também para o Replicat paralelo. Nesse modo, o processo Replicat aproveita a funcionalidade de processamento de aplicação disponível no Oracle AI Database. Nesse modo, o Replicat funciona da seguinte forma:

Lê a trilha do Oracle GoldenGate.
Executa filtragem, mapeamento e conversão de dados.
Constrói registros de alteração lógicos (LCR) que representam transações de DML ou DDL do banco de dados (na ordem de confirmação).
Vincula-se a um processo de segundo plano no banco de dados de destino conhecido como servidor de entrada do banco de dados por meio de uma interface de streaming "lightweight".
Transmite os LCRs ao servidor de entrada, que aplica os dados ao banco de dados de destino.
Um Replicat no modo integrado (normal ou paralelo) deverá ser usado se alguma das seguintes funcionalidades for utilizada:
- Detecção e resolução automáticas de conflito
- Replicação de procedimento
- Handlers de DML ou DDL

INTEGRATED deve ser usado para um Replicat on-line de sincronização de alterações que lê a partir de uma trilha local especificada pelo EXTTRAIL.

O Replicat integrado e o Replicat paralelo no modo integrado manterão a tabela de checkpoints, se ela existir. Consulte também ADD CHECKPOINTTABLE.

TRACETABLE não é mantido pelo Replicat integrado ou pelo Replicat paralelo no modo integrado.

Quando no modo integrado, o Replicat não suporta os seguintes parâmetros:

BULKLOAD (Não use o Replicat integrado como um Replicat de carga inicial.)
GENLOADFILES
SHOWSYNTAX
MAXTRANSOPS (é ignorado)

PARALLEL

Válido para todos os bancos de dados com suporte.

Adiciona o Replicat no modo paralelo. Nesse modo, o Replicat aplica transações em paralelo para melhorar o desempenho. Ela leva em conta as dependências entre as transações. PARALLEL INTEGRATED O Replicat é válido somente para Oracle. Ele adiciona o Replicat paralelo no modo integrado, que, como Replicat Integrado, aproveita a funcionalidade de processamento de aplicação disponível no Oracle AI Database.

Observação: Ao configurar o Replicat paralelo para Sybase, certifique-se de fazer upgrade para a versão 16.0 SP3 PL15 e posterior para impedir que o Serviço de Administração se desconecte intermitentemente.

COORDINATED [MAXTHREADS number]

Cria o Replicat no modo coordenado. Um Replicat coordenado é colocado em multithread para ativar o processamento paralelo. Essa opção adiciona o coordenador (identificado pelo nome do grupo) e o número máximo de threads de processamento especificados por padrão ou com MAXTHREADS. As dependências são computadas e coordenadas pelo coordenador e o processamento de SQL é executado pelos threads.

Para criar um processo Replicat COORDINATED, é necessária uma tabela de checkpoint.

COORDINATED deve ser usado para um Replicat on-line de sincronização de alterações que lê a partir de uma trilha local especificada pelo EXTTRAIL. Observação: O nome do grupo de um Replicat coordenado pode conter apenas cinco caracteres.

MAXTHREADS number

Especifica o número máximo de threads de processamento que esse grupo Replicat pode gerar. Esses threads são todos criados durante a inicialização, mas dependendo do que for especificado nas instruções MAP no arquivo de parâmetro, alguns ou todos esses threads processarão a carga de trabalho a qualquer momento. Como regra geral, especifique duas vezes o número de threads que você especificar nas instruções MAP ao particionar a carga de trabalho. Isso permite adicionar threads caso a carga de trabalho aumente, sem precisar eliminar e recriar o grupo Replicat. Consulte TABLE \| MAP para mais informações sobre como particionar a carga de trabalho entre threads.

O número padrão de threads será 25 se MAXTHREADS for omitido. O número máximo de threads é 500.

MAXTHREADS tem um relacionamento com o parâmetro MAXGROUPS. MAXGROUPS controla o número máximo de grupos de processo (Extrair e Replicat) permitido por instância do Oracle GoldenGate. Cada thread de Replicat é considerado um grupo de Replicat no contexto do MAXGROUPS. Portanto, o número de grupos de Extract e Replicat na instância do Oracle GoldenGate, mais o valor de MAXTHREADS, não pode exceder o valor de MAXGROUPS, consulte MAXGROUPS

EXTTRAIL trail_name

Especifica o nome relativo ou totalmente qualificado de uma trilha que foi criada com o comando ADD EXTTRAIL.

BEGIN {NOW yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z}

Define um checkpoint inicial na trilha.

NOW

Começa a replicar as alterações desde o momento em que o grupo é criado.

yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z

Começa a extrair as alterações a partir de um momento específico.

EXTRBA extrba

Válido para Db2 z/OS.

Especifica o endereço de byte relativo dentro do arquivo de trilha especificado pelo EXTSEQNO. Entre em contato com o Suporte Técnico da Oracle antes de usar essa opção.

CHECKPOINTTABLE {owner.table NODBCHECKPOINT}

Não válido para Oracle GoldenGate Applications Adapter ou Oracle GoldenGate Big Data.

NODBCHECKPOINT não é válido para o Oracle AI Database de destino. A Oracle recomenda o uso de uma tabela de checkpoint. O Replicat paralelo e coordenado nos modos integrado e não integrado requer uma tabela de checkpoints.

Especifica que esse grupo Replicat gravará checkpoints na tabela especificada do banco de dados. Inclua o proprietário e o nome da tabela, conforme ggadmin.ggs_checkpoint. Este argumento substitui qualquer especificação de CHECKPOINTTABLE padrão no arquivo GLOBALS. A tabela deve ser adicionada primeiro com o comando ADD CHECKPOINTTABLE.

Para bancos de dados não-Oracle de destino, quando NODBCHECKPOINT for especificado, o grupo Replicat não gravará pontos de verificação em uma tabela de pontos de verificação. Este argumento substitui qualquer especificação de CHECKPOINTTABLE padrão no arquivo GLOBALS. Esse argumento será obrigatório se você não quiser usar uma tabela de checkpoints com o grupo Replicat que está sendo criado.

Para o destino do Oracle AI Database, o Oracle GoldenGate 26ai e versões posteriores não suportarão o parâmetro NODBCHECKPOINT ao adicionar um Replicat. Após o upgrade para o Oracle GoldenGate 26ai, se o Replicat existente para o Oracle AI Database tiver sido criado com NODBCHECKPOINT e nenhum ponto de verificação de banco de dados padrão tiver sido especificado em GLOBALS, o Replicat será encerrado na inicialização. Para evitar esse problema, você deve executar uma das seguintes tarefas:

Opção 1: A Oracle recomenda que você especifique uma tabela de checkpoint de banco de dados padrão em GLOBALS

Opção 2: Crie um novo Replicat com a tabela de checkpoints especificada e reinicie pelo SCN que substitui o Replicat cujo upgrade foi feito.

DESC ‘description’

Especifica uma descrição do grupo, como 'Loads account_tab on Serv2'. Coloque a descrição entre aspas.

ENCRYPTIONPROFILE

Especifica o nome do perfil de criptografia para o Replicat.

CRITICAL

Indica se o processo é crítico para a implantação

PROFILE

Nome do perfil de início automático.

AUTOSTART

Especifica se o processo gerenciado deverá ser iniciado automaticamente quando o Administration Service for iniciado. O valor padrão é YES.

DELAY

Tempo de espera em segundos antes de iniciar o processo.

AUTORESTART

Controla como o processo será reiniciado se ele terminar.

RETRIES

O número máximo de tentativas de reiniciar a tarefa antes de cancelar os esforços de repetição. Essa definição é opcional.

WAITSECONDS

A duração (em segundos) na qual as novas tentativas são contadas.

RESETSECONDS

Redefine a duração na qual as novas tentativas são contadas.

DISABLEONFAILURE

Se for definido como TRUE, a tarefa será desativada quando o número de novas tentativas for esgotado.

Exemplos

O exemplo a seguir adiciona um Replicat integrado chamado reps. A saída é exibida usando o comando INFO.

ADD REPLICAT reps, INTEGRATED, EXTTRAIL ea, checkpointtable ggadmin.ckpt1

A saída é mostrada como:

2019-11-21T20:01:10Z  INFO    OGG-08100  REPLICAT (Integrated) added.

Veja um exemplo de adição de um Replicat paralelo chamado repw.

ADD REPLICAT repw, INTEGRATED, PARALLEL, EXTTRAIL ea, checkpointtable ggadmin.ggs_checkpoint

A saída mostra:

2019-11-21T20:07:26Z  INFO    OGG-08100  REPLICAT (Parallel) added.