ADD EXTTRAIL

Use ADD EXTTRAIL para criar uma trilha para processamento on-line no sistema local e:

Associe a trilha com um grupo Extract.
Designe um tamanho máximo de arquivo.
Ao tentar criar vários arquivos de trilha usando ADD EXTTRAIL, em um único processo Extract, a operação falhará se o número de arquivos de trilha exceder um determinado limite. Especificamente, quando mais de 12 trilhas são criadas, o seguinte erro pode ocorrer:
```
2025-11-05T21:16:04Z  INFO    OGG-08100  Exceeded checkpoint record size (32,768/32,767) in

checkpoint file /path/to/checkpoint/file.cpe.
```
Este erro ocorre porque o arquivo de checkpoint excede o limite de tamanho de 32.767 registros. O arquivo de checkpoint contém CSN (Commit Sequence Number), XID (Transaction ID) e números de registro, que contribuem para o tamanho do arquivo.

Para evitar esse erro, é recomendável não criar vários arquivos de trilha de um único Extract, principalmente por motivos de desempenho. A abordagem preferida é ter um único Extract que capture todos os dados necessários e use o Serviço de Distribuição para distribuí-los para diferentes destinos.

Outra opção alternativa é executar vários processos Extract se houver a necessidade de reduzir o tamanho do arquivo de trilha para cada destino individual.

Consulte EXTTRAIL na Referência de Parâmetros e Funções do Oracle GoldenGate

Sintaxe

ADD EXTTRAIL trail_name, EXTRACT group_name
[, MEGABYTES n]
[SEQNO n]

trail_name

Um nome de trilha com dois caracteres. Recomenda-se que ambos os caracteres sejam alfabéticos, mas o primeiro caractere não deve ser um número. O Oracle GoldenGate acrescenta a esse nome um número sequencial com nove dígitos sempre que um novo arquivo é criado.

O nome da trilha também pode ser prefixado com um diretório. Por exemplo, uma trilha chamada north/ea teria arquivos de trilha chamados ea000000000, ea000000001 no subdiretório $OGG_DATA_HOME/north.

group_name

O nome do grupo Extract ao qual a trilha está vinculada. Uma trilha só pode ser designada a um Extract. Múltiplos Extracts não podem gravar na mesma trilha. No entanto, um Extract pode gravar em várias trilhas distintas, se necessário, mas isso normalmente não é necessário.

MEGABYTES n

O tamanho máximo, em megabytes, de cada arquivo de trilha na sequência. O padrão é 500 MB, e o valor máximo é 2.000 MB.

SEQNO n

Especifica que o primeiro arquivo da trilha começará com o número sequencial de trilha especificado. Não inclua nenhum preenchimento com zero. Por exemplo, para começar na sequência 3 de uma trilha chamada tr, especifique SEQNO 3. O arquivo real seria nomeado /ea000000003. Essa opção pode ser usada durante a solução de problemas quando um Replicat precisa ser reposicionado para um determinado número da sequência da trilha. Ela elimina a necessidade de alterar o processo Replicat para ler o número de sequência necessário. O valor padrão é 1.

Limitações

Ao criar uma trilha de Extract com o mesmo nome de uma trilha de Extract anterior, certifique-se de que todas as trilhas desse diretório com o mesmo trail_name tenham sido excluídas.

Ao fazer a captura de um banco de dados MySQL ativado para replicação de grupo, só uma trilha é permitida para um Extract.

Exemplos

O seguinte comando cria um nome de trilha ea:

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

A saída é exibida da seguinte forma:

2019-11-20T23:49:19Z  INFO    OGG-08100  EXTTRAIL added.