EXTTRAIL

Válido Para

Extrair

Descrição

Use o parâmetro EXTTRAIL para especificar uma trilha no sistema local que foi criada com o comando ADD EXTTRAIL. A trilha é lida por um Caminho de Distribuição ou por um Replicat no sistema local.

EXTTRAIL deve preceder todas as instruções TABLE associadas. Várias instruções EXTTRAIL podem ser usadas para definir diferentes trilhas para um Extract, exceto para um Extract MySQL ao usar o posicionamento definido de GTID como somente uma trilha é suportada.

A partir do Oracle GoldenGate 19c, o Extract principal grava arquivos de trilha no mesmo formato dos arquivos de trilha existentes durante um upgrade, a menos que você especifique explicitamente a versão do formato do arquivo de trilha usando a opção FORMAT RELEASE. Isso impede que os Replicats subsequentes sejam interrompidos se não tiverem upgrade.

Você pode criptografar os dados nessa trilha usando o parâmetro ENCRYPTTRAIL. Para obter mais informações, consulte "ENCRYPTTRAIL \| NOENCRYPTTRAIL".

Observação: Ao usar o parâmetro ENCRYPTRAIL com o parâmetro EXTTRAIL, certifique-se de que o parâmetro ENCRYPTRAIL seja mencionado antes de EXTTRAIL; caso contrário, a trilha não será criptografada.

Observação: as trilhas locais que devem ser consumidas por um Caminho de Distribuição enviando ao NSK, você deve usar TRAILBYTEORDER BIGENDIAN. Não é possível alterar isso no data pump.

Padrão

Nenhum

Sintaxe

EXTTRAIL <file_name>
[, FORMAT RELEASE <major>.<minor>]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

<trail_name>

O nome do caminho relativo ou totalmente qualificado da trilha. O nome da trilha só pode conter dois caracteres.

Observação: Na Arquitetura de Microsserviços, o prefixo de dois caracteres de nome de arquivo de trilha deve começar com apenas uma letra.

O Oracle GoldenGate acrescenta a esse nome um número sequencial com nove dígitos sempre que um novo arquivo é criado. Por exemplo, uma trilha chamada /tr teria arquivos nomeados /tr000000001, /tr000000002.

FORMAT RELEASE <major.minor>

Válido para um Extract. Especifica o formato de metadados dos dados que são enviados pelo Extract a uma trilha, um arquivo ou (se for uma tarefa remota) a outro processo. Os metadados informam ao processo do leitor se os registros de dados são de uma versão suportada. O formato dos metadados depende da versão do processo do Oracle GoldenGate. As versões mais antigas do Oracle GoldenGate contêm metadados diferentes dos das versões mais novas.

FORMAT RELEASE especifica uma versão do Oracle GoldenGate release. major é o número de versão principal e minor é o número de versão secundária. Os valores major.minor devem refletir uma versão atual ou anterior do Oracle GoldenGate, disponível em geral (GA). Os valores válidos são 11.2 por meio do número de versão atual do Oracle GoldenGate X.x, por exemplo, 23.26 ou 19.1.

A versão da release é programaticamente mapeada de volta ao nível de compatibilidade de formato de trilha apropriado. O padrão é a versão atual do processo que é gravado nesta trilha. Observação: RELEASE versões anteriores à 12.1 não suportam nomes de objetos de três partes.

Observação: se estiver usando várias trilhas em um único Extract, somente as versões RELEASE iguais poderão coexistir.

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

Define o formato de byte dos arquivos de trilha. Válido somente para trilhas que tenham uma versão FORMAT RELEASE de pelo menos 12.1. Os valores válidos são BIGENDIAN (big endian), LITTLEENDIAN (little endian) e NATIVEENDIAN. O padrão é NATIVEENDIAN. Consulte a versão GLOBALS do TRAILBYTEORDER para obter instruções de uso adicionais.

Exemplos

Exemplo 1

EXTTRAIL ny

Exemplo 2

No Linux:

EXTTRAIL trails/ny, FORMAT RELEASE 12.3

Exemplo 3

No Windows:

EXTTRAIL trails\ny, FORMAT RELEASE 12.3

Exemplo 4

Dois formatos de trilha dentro dos mesmos conjuntos de tabelas que estão sendo capturados:

EXTTRAIL ea
TABLE hr.tab1
TABLE hr.tab2
EXTTRAIL eb
TABLE scott.tab3
TABLE scott.tab4