ARQUIVO DE DEFINIÇÕES

Válido Para

DEFGEN

Descrição

Use o parâmetro DEFSFILE para identificar o nome do arquivo no qual o DEFGEN gravará definições de dados. Por padrão, o arquivo de definições de dados é gravado no conjunto de caracteres do sistema operacional local. É possível alterar o conjunto de caracteres com a opção CHARSET.

Padrão

Nenhum

Sintaxe

DEFSFILE <file_name> [APPEND | PURGE] [CHARSET <character_set>] [FORMAT RELEASE <major>.<minor>]

<file_name>

O nome do arquivo relativo ou totalmente qualificado. O arquivo é criado quando você executa o DEFGEN.

APPEND

Direciona DEFGEN para gravar novo conteúdo (da execução atual) no final de qualquer conteúdo existente, se o arquivo especificado já existir. Se o arquivo de definições já existir, mas for de uma versão mais antiga do Oracle GoldenGate, você poderá definir a opção FORMAT RELEASE como a mesma versão do arquivo existente para evitar erros. Caso contrário, o DEFGEN tentará adicionar recursos de metadados mais recentes e encerrará. Estas são as restrições ao usar APPEND:

Se o arquivo de definições de dados existente estiver em um formato anterior ao Oracle GoldenGate 11.2.1, o DEFGEN anexará as definições de tabela no formato antigo, em que não há suporte para nomes de tabela e coluna com vários bytes e caracteres especiais.
Se o arquivo de definições de dados existente estiver no formato mais recente introduzido na versão 11.2.1, o DEFGEN anexará as definições de tabela no conjunto de caracteres existente do arquivo.
Se o arquivo existente for da versão 11.2 ou anterior, ele foi gravado quando o DEFGEN não suportava nomes de objetos de três partes e causará um erro se os novos metadados contiverem nomes de três partes. Você poderá especificar objetos de um banco de dados contêiner Oracle se remover o contêiner ou a parte do catálogo usando o parâmetro NOCATALOG no arquivo de parâmetros DEFGEN.

PURGE

Direciona DEFGEN para expurgar o arquivo especificado antes de gravar novo conteúdo da execução atual. Ao usar PURGE, você pode substituir um arquivo de definições existente que foi criado por uma versão mais antiga do DEFGEN por metadados mais recentes que suportem recursos mais recentes, como nomes de objetos de três partes.

CHARSET <character_set>

Gera o arquivo de definições no conjunto de caracteres especificado. Sem CHARSET, o conjunto de caracteres padrão do sistema operacional é usado. Se o modo APPEND for especificado para um arquivo de definições que seja versão 11.2.1 ou posterior, CHARSET será ignorado e o conjunto de caracteres do arquivo de definições existente será usado.

FORMAT RELEASE <major.minor>

Especifica o formato de metadados das definições enviadas pelo DEFGEN para o arquivo de definições. Os metadados informam ao processo do leitor se os registros do arquivo são de uma versão que ele suporta. 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. Use FORMAT quando o arquivo de definições for usado por um processo que seja de uma versão mais antiga do Oracle GoldenGate que a atual.

FORMAT é uma palavra-chave obrigatória.
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. O X.x deve refletir uma versão atual ou anterior do Oracle GoldenGate, disponível em geral (GA). Os valores válidos são 9.0 por meio do número de versão atual do Oracle GoldenGate X.x, por exemplo, 11.2 ou 12.1. (Se você usar uma versão do Oracle GoldenGate anterior à 9.0, especifique 9.0 ou 9.5.)

A versão da liberação é mapeada de volta de forma programática para um nível apropriado de compatibilidade interna. O padrão é a versão atual do processo que é gravado nesta trilha. Observe que as versões do RELEASE anteriores à 12.1 não suportam nomes de objeto de três partes.

FORMAT RELEASE <major.minor>

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. O X.x deve refletir uma release atual ou anterior, de disponibilidade geral (GA) do Oracle GoldenGate. Os valores válidos são 11.1 até o número de versão atual do Oracle GoldenGate X.x, por exemplo, 11.2 ou 12.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.

Há suporte para as seguintes definições no Oracle Database 12.2 e versões mais recentes:

Para o Oracle Database 12.2 não CDB ou superior com compatibilidade definida como 12.1, FORMAT RELEASE 12.2 ou superior é compatível.
Para o Oracle Database 12.2 não CDB ou superior com compatibilidade definida como 12.2, FORMAT RELEASE 12.2 ou superior é compatível.
Para CDB/PDB do Oracle Database 12.2 ou superior com compatibilidade definida como 12.2, somente valores FORMAT RELEASE 12.3 ou superior são suportados. Isso se deve ao uso de undo local para PDBs, o que exige o aumento da transação ID com o número de PDB para garantir a exclusividade dos IDs de transações.

Exemplo

DEFSFILE ./dirdef/orcldef CHARSET ISO-8859-11 FORMAT RELEASE 11.2