ARQUIVO DE DESCARTE | NODISCARDFILE

Válido Para

Extract e Replicat

Descrição

Use o parâmetro DISCARDFILE para fazer o seguinte:

• Personalize o nome, o local, o tamanho e o modo de gravação do arquivo de descarte. Por padrão, um arquivo de descarte é gerado sempre que um processo é iniciado com o comando START. Para manter as propriedades padrão, não é necessário um parâmetro DISCARDFILE.

• Especifique o uso de um arquivo de descarte para métodos de processamento em que o processo começa na linha de comando do sistema operacional e um arquivo de descarte não é criado por padrão.

Utilize o parâmetro NODISCARDFILE para desativar o uso de um arquivo descartado. Se NODISCARDFILE for usado com DISCARDFILE, o processo será interrompido.

Ao utilizar DISCARDFILE, utilize a opção PURGE ou APPEND. Caso contrário, você deverá especificar outro nome de arquivo de descarte antes de iniciar cada execução de processo, porque o Oracle GoldenGate não gravará em um arquivo de descarte existente sem uma dessas instruções e será encerrado.

Consulte "DISCARDROLLOVER" para saber como controlar com que frequência o arquivo de descarte é rolado para um novo arquivo.

Para obter mais informações sobre o arquivo de descarte, consulte Visão Geral do Tratamento de Erros do Oracle GoldenGate.

Padrão

Se um processo for iniciado com o comando START, ele gerará um arquivo de descarte da seguinte forma:

• O arquivo é nomeado após o processo que o cria, com uma extensão .dsc. Se o processo for um Replicat coordenado, ele gerará um arquivo por thread. Cada nome de arquivo é anexado com o thread ID do thread correspondente.

• O arquivo é criado no subdiretório dirrpt do diretório de instalação do Oracle GoldenGate.

• O tamanho máximo do arquivo é de 50 MB.

• Na inicialização, se existir um arquivo de descarte, ele será expurgado antes de novos dados serem gravados.

• O nome máximo do arquivo é 250 caracteres, incluindo o diretório.

Quando você inicia um processo a partir da linha de comando do sistema operacional, não deve gerar um arquivo de descarte por padrão.

Sintaxe

DISCARDFILE { [<file_name>]
[, APPEND | PURGE]
[, MAXBYTES <n> | MEGABYTES <n>] } |
NODISCARDFILE

DISCARDFILE

Indica que o nome ou outro atributo do arquivo de descarte está sendo alterado.

<file_name>

O nome relativo ou totalmente qualificado do arquivo de descarte, incluindo o nome do arquivo real. Para um Replicat coordenado, especifique um nome de arquivo de até cinco caracteres, porque cada nome de arquivo é anexado ao thread ID do thread que o grava. Para armazenar o arquivo no diretório do Oracle GoldenGate, um nome de caminho relativo é suficiente porque o Oracle GoldenGate qualifica o nome com o diretório de instalação do Oracle GoldenGate.

APPEND

Adiciona novo conteúdo ao conteúdo existente se o arquivo já existir. Se nem APPEND nem PURGE forem usados, você deverá especificar um nome de arquivo de descarte diferente antes de iniciar cada execução de processo.

PURGE

Limpa o arquivo antes de gravar novo conteúdo. Se nem PURGE nem APPEND forem usados, você deverá especificar um nome de arquivo de descarte diferente antes de iniciar cada execução de processo.

MAXBYTES <n>

Define o tamanho máximo do arquivo em bytes. O intervalo válido é de 1 a 4096967295. O padrão é 3000000. Se o tamanho especificado for excedido, o processo será interrompido.

MEGABYTES <n>

Define o tamanho máximo do arquivo em megabytes. O intervalo válido é de 1 a 4096. O padrão é 3. Se o tamanho especificado for excedido, o processo será interrompido.

NODISCARDFILE

Impede que o processo crie um arquivo de descarte.

Exemplo

Exemplo 1

Este exemplo especifica um nome de arquivo e uma extensão não padrão, um modo de gravação não padrão e um tamanho máximo de arquivo não padrão. Este exemplo mostra como você pode alterar as propriedades padrão de um arquivo de descarte para um processo on-line ou especificar o uso de um arquivo de descarte para um processo que começa na linha de comando do sistema operacional e não tem nenhum arquivo de descarte por padrão.

DISCARDFILE .dirrpt/discard.txt, APPEND, MEGABYTES 20

Exemplo 2

Este exemplo altera apenas o modo de gravação do arquivo de descarte padrão para um processo on-line.

DISCARDFILE .dirrpt/finance.dsc, APPEND

Exemplo 3

Este exemplo desativa o uso de um arquivo de descarte para um processo on-line.

NODISCARDFILE