defgen

Observação: certifique-se de definir as variáveis de ambiente conforme descrito na seção Oracle GoldenGate Programs, para poder usar o utilitário DEFGEN.

Use o utilitário DEFGEN para gerar definições de metadados da tabela de origem, que podem ser usadas por um processo Replicat para leitura de um arquivo de trilha que esteja em uma release de formato anterior ao Oracle GoldenGate 12.2 e que não contenha metadados da tabela de origem. O programa DEFGEN é instalado no home do Oracle GoldenGate, diretório bin.

Sintaxe para Windows, UNIX e Linux

defgen PARAMFILE <parameter_file>
[NOEXTATTR]
[PAUSEATEND | NOPAUSEATEND]
[REPORTFILE <report_file>]
[UPDATECS <characterset> ]

PARAMFILE <parameter_file>

Obrigatório. Especifica o nome do caminho relativo ou absoluto do arquivo de parâmetros para o programa DEFGEN que está sendo executado. O arquivo de parâmetros deve ser criado manualmente e listará um arquivo defs para saída de definição de tabela, informações de conexão de banco de dados e quais tabelas gerar definições.

NOEXTATTR

Pode ser usado para oferecer suporte à compatibilidade com versões do Oracle GoldenGate anteriores à Versão 11.2.1 e não suportam conjuntos de caracteres diferentes de ASCII, nem distinção entre maiúsculas e minúsculas ou nomes de objetos que são citados com espaços. NOEXTATTR impede que DEFGEN inclua a configuração regional do banco de dados e o conjunto de caracteres que suportam os recursos de globalização introduzidos no Oracle GoldenGate Versão 11.2.1. Se o nome da tabela ou da coluna tiver caracteres especiais ou de vários bytes, como espaços em branco, DEFGEN não incluirá a definição da tabela quando NOEXTATTR for especificado. Se o modo APPEND for usado no arquivo de parâmetros, NOEXTATTR será ignorado e a nova definição de tabela será anexada no formato de arquivo existente, seja com os atributos extras ou não.

PAUSEATEND

NOPAUSEATEND (padrão)

(Somente Windows) Quando o processo é interrompido, um usuário do Oracle GoldenGate deve observar a saída da console e, em seguida, pressionar qualquer tecla para limpá-la. Indica também se o processo terminou normal ou anormalmente.

REPORTFILE <report_file>

Envia a saída do comando para o arquivo de relatório especificado. Sem a opção reportfile, a saída do comando é impressa na tela.

defs_file UPDATECS <charset>

Converte o conjunto de caracteres de um arquivo de definições em outro conjunto de caracteres se o arquivo for transferido para um sistema operacional com um conjunto de caracteres incompatível. Este procedimento usa o nome do arquivo de definições e o conjunto de caracteres de destino como entrada. Por exemplo: defgen source.def UPDATECS UTF-8.

UPDATECS ajuda em situações como quando um nome de tabela japonês no Windows japonês é gravado no Windows CP932 para o arquivo de definição de dados e, em seguida, o arquivo de definições é transferido para o UNIX japonês. O arquivo não pode ser usado, a menos que o UNIX esteja configurado na configuração regional PCK. Assim, você deve usar UPDATECS para converter a codificação do arquivo de definições para o formato correto.

Exemplo

Veja a seguir um arquivo de parâmetros de amostra DEFGEN, defgenparam.prm. Consulte o parâmetro DEFSFILE para obter detalhes.

DEFSFILE /home/oracle/ogg/ora/bin/ora.defs, PURGE
USERIDALIAS oracle_source
TABLE hr.employees;

Execute o seguinte comando para executar o programa DEFGEN:

$OGG_HOME/bin/defgen PARAMFILE defgenparam.prm