FICHIER DE REBUT | NODISCARDFILE

Durée de validité

Extraction et réplication

Description

Utilisez le paramètre DISCARDFILE pour effectuer les opérations suivantes :

• Personnaliser le nom, l'emplacement, la taille et le mode d'écriture du fichier de rebut. Par défaut, un fichier de rebut est généré chaque fois qu'un processus est démarré avec la commande START. Pour conserver les propriétés par défaut, aucun paramètre DISCARDFILE n'est requis.

• Indiquez l'utilisation d'un fichier de rebut pour les méthodes de traitement où le processus démarre à partir de la ligne de commande du système d'exploitation et où aucun fichier de rebut n'est créé par défaut.

Pour désactiver l'utilisation d'un fichier de rebut, utilisez le paramètre NODISCARDFILE. Si NODISCARDFILE est utilisé avec DISCARDFILE, le processus est abandonné.

Lorsque vous utilisez DISCARDFILE, utilisez l'option PURGE ou APPEND. Sinon, vous devez indiquer un nom de fichier de rebut différent avant de lancer chaque exécution de processus, car Oracle GoldenGate n'écrira pas dans un fichier de rebut existant sans l'une de ces instructions et prendra fin.

Reportez-vous à "DISCARDROLLOVER" pour savoir comment contrôler la fréquence à laquelle le fichier de rebut est reporté dans un nouveau fichier.

Pour plus d'informations sur le fichier de rebut, reportez-vous à Présentation du traitement des erreurs Oracle GoldenGate.

Valeur par défaut

Si un processus est démarré avec la commande START, il génère un fichier de rebut comme suit :

• Le fichier porte le nom du processus qui le crée, avec l'extension .dsc. Si le processus est une réplication coordonnée, il génère un fichier par thread. Chaque nom de fichier est ajouté au thread ID du thread correspondant.

• Le fichier est créé dans le sous-répertoire dirrpt du répertoire d'installation d'Oracle GoldenGate.

• La taille maximale de fichier est de 50 Mo

• Au démarrage, si un fichier de rebut existe, il est purgé avant l'écriture de nouvelles données.

• Le nom de fichier maximal est de 250 caractères, y compris le répertoire.

Lorsque vous démarrez un processus à partir de la ligne de commande du système d'exploitation, vous ne devez pas générer de fichier de rebut par défaut.

Syntaxe

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

DISCARDFILE

Indique que le nom ou l'autre attribut du fichier de rebut est en cours de modification.

<file_name>

Nom relatif ou complet du fichier de rebut, y compris le nom réel du fichier. Pour une réplication coordonnée, indiquez un nom de fichier comportant jusqu'à cinq caractères, car chaque nom de fichier est ajouté au thread ID du thread qui l'écrit. Pour stocker le fichier dans le répertoire Oracle GoldenGate, un nom de chemin relatif est suffisant, car Oracle GoldenGate qualifie le nom avec le répertoire d'installation Oracle GoldenGate.

APPEND

Ajoute un nouveau contenu au contenu existant si le fichier existe déjà. Si ni APPEND ni PURGE n'est utilisé, vous devez indiquer un nom de fichier de rebut différent avant de démarrer chaque exécution de processus.

PURGE

Purge le fichier avant d'écrire un nouveau contenu. Si ni PURGE ni APPEND n'est utilisé, vous devez indiquer un nom de fichier de rebut différent avant de démarrer chaque exécution de processus.

MAXBYTES <n>

Définit la taille maximale du fichier en octets. La plage valide va de 1 à 4096967295. La valeur par défaut est 3000000. Si la taille spécifiée est dépassée, le processus est abandonné.

MEGABYTES <n>

Définit la taille maximale du fichier, en mégaoctets. La plage valide va de 1 à 4096. La valeur par défaut est 3. Si la taille spécifiée est dépassée, le processus est abandonné.

NODISCARDFILE

Empêche le processus de créer un fichier de rebut.

Exemple

Exemple 1

Cet exemple spécifie un nom de fichier et une extension autres que par défaut, un mode d'écriture autre que par défaut et une taille de fichier maximale autre que par défaut. Cet exemple montre comment modifier les propriétés par défaut d'un fichier de rebut pour un processus en ligne ou spécifier l'utilisation d'un fichier de rebut pour un processus qui démarre à partir de la ligne de commande du système d'exploitation et qui n'a pas de fichier de rebut par défaut.

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

Exemple 2

Cet exemple modifie uniquement le mode d'écriture du fichier de rebut par défaut pour un processus en ligne.

DISCARDFILE .dirrpt/finance.dsc, APPEND

Exemple 3

Cet exemple désactive l'utilisation d'un fichier de rebut pour un processus en ligne.

NODISCARDFILE