ARCHIVO DE DESECHO | NODISCARDFILE

Válido para

Extraer y Replicat

Descripción

Utilice el parámetro DISCARDFILE para realizar lo siguiente:

• Personalice el nombre, la ubicación, el tamaño y el modo de escritura del archivo de desecho. Por defecto, se genera un archivo de desecho cada vez que se inicia un proceso con el comando START. Para conservar las propiedades por defecto, no es necesario un parámetro DISCARDFILE.

• Especifique el uso de un archivo de desecho para los métodos de procesamiento en los que el proceso se inicia desde la línea de comandos del sistema operativo y no se crea un archivo de desecho por defecto.

Utilice el parámetro NODISCARDFILE para desactivar el uso de un archivo de desecho. Si se utiliza NODISCARDFILE con DISCARDFILE, el proceso finaliza de forma anormal.

Al utilizar DISCARDFILE, utilice la opción PURGE o APPEND. De lo contrario, debe especificar un nombre de archivo de desecho diferente antes de iniciar cada ejecución de proceso, ya que Oracle GoldenGate no escribirá en un archivo de desecho existente sin una de estas instrucciones y terminará.

Consulte "DISCARDROLLOVER" para obtener información sobre cómo controlar la frecuencia con la que el archivo de desecho se transfiere a un nuevo archivo.

Para obtener más información sobre el archivo de desecho, consulte Visión general del manejo de errores de Oracle GoldenGate.

Valor por defecto

Si un proceso se inicia con el comando START, genera un archivo de desecho de la siguiente manera:

• El nombre del archivo se debe al proceso que lo crea, con una extensión .dsc. Si el proceso es un Replicat coordinado, genera un archivo por thread. Cada nombre de archivo se agrega con el thread ID del thread correspondiente.

• El archivo se crea en el subdirectorio dirrpt del directorio de instalación de Oracle GoldenGate.

• El tamaño máximo de archivo es 50 MB.

• En el inicio, si existe un archivo de desecho, se depura antes de que se escriban nuevos datos.

• El nombre de archivo máximo es de 250 caracteres, incluido el directorio.

Al iniciar un proceso desde la línea de comandos del sistema operativo, no debe generar un archivo de desecho por defecto.

Sintaxis

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

DISCARDFILE

Indica que se está cambiando el nombre u otro atributo del archivo de desecho.

<file_name>

Nombre relativo o totalmente cualificado del archivo de desecho, incluido el nombre de archivo real. Para un Replicat coordinado, especifique un nombre de archivo de hasta cinco caracteres, ya que cada nombre de archivo se agrega al thread ID del thread que lo escribe. Para almacenar el archivo en el directorio de Oracle GoldenGate, basta con un nombre de ruta relativo, ya que Oracle GoldenGate cualifica el nombre con el directorio de instalación de Oracle GoldenGate.

APPEND

Agrega contenido nuevo al contenido existente si el archivo ya existe. Si no se utiliza APPEND ni PURGE, debe especificar un nombre de archivo de desecho diferente antes de iniciar cada ejecución de proceso.

PURGE

Depura el archivo antes de escribir contenido nuevo. Si no se utiliza PURGE ni APPEND, debe especificar un nombre de archivo de desecho diferente antes de iniciar cada ejecución de proceso.

MAXBYTES <n>

Define el tamaño máximo del archivo en bytes. El rango válido es de 1 a 4096967295. Por defecto es 3000000. Si se supera el tamaño especificado, el proceso finaliza de forma anormal.

MEGABYTES <n>

Define el tamaño máximo del archivo en megabytes. El rango válido es de 1 a 4096. El valor por defecto es 3. Si se supera el tamaño especificado, el proceso finaliza de forma anormal.

NODISCARDFILE

Impide que el proceso cree un archivo de desecho.

Ejemplo

Ejemplo 1

En este ejemplo, se especifica un nombre de archivo y una extensión no predeterminados, un modo de escritura no predeterminado y un tamaño de archivo máximo no predeterminado. En este ejemplo se muestra cómo puede cambiar las propiedades por defecto de un archivo de desecho para un proceso en línea o especificar el uso de un archivo de desecho para un proceso que se inicia desde la línea de comandos del sistema operativo y no tiene ningún archivo de desecho por defecto.

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

Ejemplo 2

En este ejemplo, sólo se cambia el modo de escritura del archivo de desecho por defecto para un proceso en línea.

DISCARDFILE .dirrpt/finance.dsc, APPEND

Ejemplo 3

En este ejemplo, se desactiva el uso de un archivo de desecho para un proceso en línea.

NODISCARDFILE