DATEI VERWERFEN | NODISCARDFILE

Gültig für

Extract und Replicat

Beschreibung

Verwenden Sie den Parameter DISCARDFILE, um Folgendes auszuführen:

• Passen Sie Name, Speicherort, Größe und Schreibmodus der Discard-Datei an. Standardmäßig wird eine Discard-Datei generiert, wenn ein Prozess mit dem Befehl START gestartet wird. Um die Standardeigenschaften beizubehalten, ist kein Parameter DISCARDFILE erforderlich.

• Geben Sie die Verwendung einer Discard-Datei für Verarbeitungsmethoden an, bei denen der Prozess über die Befehlszeile des Betriebssystems beginnt und keine Discard-Datei standardmäßig erstellt wird.

Verwenden Sie den Parameter NODISCARDFILE, um die Verwendung einer Discard-Datei zu deaktivieren. Wenn NODISCARDFILE mit DISCARDFILE verwendet wird, wird der Prozess abgebrochen.

Wenn Sie DISCARDFILE verwenden, verwenden Sie entweder die Option PURGE oder APPEND. Andernfalls müssen Sie einen anderen Discard-Dateinamen angeben, bevor Sie jede Prozessausführung starten, da Oracle GoldenGate ohne eine dieser Anweisungen nicht in eine vorhandene Discard-Datei schreibt und beendet.

Wie Sie steuern, wie oft das Rollover der Discard-Datei auf eine neue Datei erfolgt, erfahren Sie unter "DISCARDROLLOVER".

Weitere Informationen zur Discard-Datei finden Sie unter Oracle GoldenGate-Fehlerbehandlung - Überblick.

Standard

Wenn ein Prozess mit dem Befehl START gestartet wird, wird eine Discard-Datei wie folgt generiert:

• Die Datei wird nach dem Prozess benannt, der sie erstellt, mit der Erweiterung .dsc. Wenn der Prozess ein koordiniertes Replicat ist, generiert er eine Datei pro Thread. An jeden Dateinamen wird der Thread ID des entsprechenden Threads angehängt.

• Die Datei wird im Unterverzeichnis dirrpt des Oracle GoldenGate-Installationsverzeichnisses erstellt.

• Die maximale Dateigröße ist 50 MB.

• Wenn beim Start eine Discard-Datei vorhanden ist, wird sie gelöscht, bevor neue Daten geschrieben werden.

• Der Dateiname darf maximal 250 Zeichen umfassen, einschließlich des Verzeichnisses.

Wenn Sie einen Prozess über die Befehlszeile des Betriebssystems starten, sollten Sie keine Discard-Datei standardmäßig generieren.

Syntax

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

DISCARDFILE

Gibt an, dass der Name oder ein anderes Attribut der Discard-Datei geändert wird.

<file_name>

Der relative oder vollständige Name der Discard-Datei, einschließlich des tatsächlichen Dateinamens. Geben Sie für ein koordiniertes Replicat einen Dateinamen mit bis zu fünf Zeichen an, da jeder Dateiname an den Thread ID des Threads angehängt wird, der ihn schreibt. Um die Datei im Oracle GoldenGate-Verzeichnis zu speichern, ist ein relativer Pfadname ausreichend, da Oracle GoldenGate den Namen mit dem Oracle GoldenGate-Installationsverzeichnis qualifiziert.

APPEND

Fügt neuen Inhalt zu vorhandenem Inhalt hinzu, wenn die Datei bereits vorhanden ist. Wenn weder APPEND noch PURGE verwendet wird, müssen Sie einen anderen Discard-Dateinamen angeben, bevor Sie jede Prozessausführung starten.

PURGE

Löscht die Datei, bevor neuer Inhalt geschrieben wird. Wenn weder PURGE noch APPEND verwendet wird, müssen Sie einen anderen Discard-Dateinamen angeben, bevor Sie jede Prozessausführung starten.

MAXBYTES <n>

Legt die maximale Größe der Datei in Byte fest. Der gültige Bereich liegt zwischen 1 und 4096967295. Der Standardport ist 3000000. Wenn die angegebene Größe überschritten wird, wird der Prozess abgebrochen.

MEGABYTES <n>

Legt die maximale Größe der Datei in Megabyte fest. Der gültige Bereich liegt zwischen 1 und 4096. Der Standardwert ist 3. Wenn die angegebene Größe überschritten wird, wird der Prozess abgebrochen.

NODISCARDFILE

Verhindert, dass der Prozess eine Discard-Datei erstellt.

Beispiel

Beispiel 1

In diesem Beispiel wird ein nicht standardmäßiger Dateiname und eine nicht standardmäßige Dateierweiterung, ein nicht standardmäßiger Schreibmodus und eine nicht standardmäßige maximale Dateigröße angegeben. Dieses Beispiel zeigt, wie Sie die Standardeigenschaften einer Discard-Datei für einen Onlineprozess ändern oder die Verwendung einer Discard-Datei für einen Prozess angeben können, der von der Befehlszeile des Betriebssystems aus beginnt und standardmäßig keine Discard-Datei enthält.

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

Beispiel 2

In diesem Beispiel wird nur der Schreibmodus der standardmäßigen Discard-Datei für einen Onlineprozess geändert.

DISCARDFILE .dirrpt/finance.dsc, APPEND

Beispiel 3

In diesem Beispiel wird die Verwendung einer Discard-Datei für einen Onlineprozess deaktiviert.

NODISCARDFILE