DEFSDATEI

Gültig für

DEFGEN

Beschreibung

Verwenden Sie den Parameter DEFSFILE, um den Namen der Datei zu identifizieren, in die DEFGEN Datendefinitionen schreibt. Standardmäßig wird die Datei mit den Datendefinitionen in den Zeichensatz des lokalen Betriebssystems geschrieben. Sie können den Zeichensatz mit der Option CHARSET ändern.

Standard

Keine

Syntax

DEFSFILE <file_name> [APPEND | PURGE] [CHARSET <character_set>] [FORMAT RELEASE <major>.<minor>]

<file_name>

Der relative oder vollständige Dateiname. Die Datei wird erstellt, wenn Sie DEFGEN ausführen.

APPEND

Weist DEFGEN an, neuen Inhalt (aus der aktuellen Ausführung) am Ende eines vorhandenen Inhalts zu schreiben, wenn die angegebene Datei bereits vorhanden ist. Wenn die Definitionsdatei bereits vorhanden ist, aber eine ältere Oracle GoldenGate-Releaseversion aufweist, können Sie die Option FORMAT RELEASE auf dieselbe Version wie die vorhandene Datei setzen, um Fehler zu vermeiden. Andernfalls versucht DEFGEN, neuere Metadatenfeatures hinzuzufügen und den Vorgang abzubrechen. Die folgenden Einschränkungen gelten für die Verwendung von APPEND:

• Wenn die vorhandene Datendefinitionsdatei ein Format aufweist, das älter als Oracle GoldenGate 11.2.1 ist, hängt DEFGEN die Tabellendefinitionen im alten Format an, wobei Tabellen- und Spaltennamen mit Multibyte- und Sonderzeichen nicht unterstützt werden.

• Wenn die vorhandene Datendefinitionsdatei das neuere Format aufweist, das in Version 11.2.1 eingeführt wurde, hängt DEFGEN die Tabellendefinitionen im vorhandenen Zeichensatz der Datei an.

• Wenn die vorhandene Datei aus Version 11.2 oder früher stammt, wurde sie geschrieben, als DEFGEN keine dreiteiligen Objektnamen unterstützte und einen Fehler verursacht, wenn die neuen Metadaten dreiteilige Namen enthalten. Sie können Objekte aus einer Oracle-Containerdatenbank angeben, wenn Sie den Container oder Katalogteil mit dem Parameter NOCATALOG in der Parameterdatei DEFGEN entfernen.

PURGE

Weist DEFGEN an, die angegebene Datei zu löschen, bevor neuer Inhalt aus der aktuellen Ausführung geschrieben wird. Wenn Sie PURGE verwenden, können Sie eine vorhandene Definitionsdatei, die von einer älteren Version von DEFGEN erstellt wurde, mit neueren Metadaten überschreiben, die neuere Features unterstützen, wie dreiteilige Objektnamen.

CHARSET <character_set>

Generiert die Definitionsdatei im angegebenen Zeichensatz. Ohne CHARSET wird der Standardzeichensatz des Betriebssystems verwendet. Wenn der APPEND-Modus für eine Definitionsdatei mit Version 11.2.1 oder höher angegeben wird, wird CHARSET ignoriert, und der Zeichensatz der vorhandenen Definitionsdatei wird verwendet.

FORMAT RELEASE <major.minor>

Gibt das Metadatenformat der Definitionen an, die von DEFGEN an die Definitionsdatei gesendet werden. Anhand dieser Metadaten bestimmt der Reader-Prozess, ob die Dateidatensätze eine unterstützte Version aufweisen. Das Metadatenformat ist von der Version des Oracle GoldenGate-Prozesses abhängig. Ältere Oracle GoldenGate-Versionen enthalten andere Metadaten als neuere. Verwenden Sie FORMAT, wenn die Definitionsdatei von einem Prozess verwendet wird, der eine ältere Oracle GoldenGate-Version als die aktuelle hat.

• FORMAT ist ein erforderliches Schlüsselwort.

• RELEASE gibt eine Oracle GoldenGate-Releaseversionan. <major> ist die Hauptversionsnummer und <minor> die Nebenversionsnummer. Die X.x muss ein aktuelles oder vorheriges allgemein verfügbares Oracle GoldenGate-Release enthalten. Gültige Werte sind 9.0 bis zur aktuellen Oracle GoldenGate-Versionsnummer X.x, z.B. 11.2 oder 12.1. (Wenn Sie eine Oracle GoldenGate-Version verwenden, die vor 9.0 liegt, geben Sie entweder 9.0 oder 9.5 an.)

  Die Releaseversion wird programmgesteuert auf eine angemessene interne Kompatibilitätsebene zurückgesetzt. Der Standardwert ist die aktuelle Version des Prozesses, der Daten in diesen Trail schreibt. In RELEASE-Versionen vor 12.1 werden dreiteilige Objektnamen nicht unterstützt.

FORMAT RELEASE <major.minor>

Gibt das Metadatenformat der Daten an, die von Extract an einen Trail, eine Datei oder (bei einer Remoteaufgabe) an einen anderen Prozess gesendet werden. Anhand der Metadaten bestimmt der Reader-Prozess, ob die Datensätze eine unterstützte Version aufweisen. Das Metadatenformat ist von der Version des Oracle GoldenGate-Prozesses abhängig. Ältere Oracle GoldenGate-Versionen enthalten andere Metadaten als neuere.

FORMAT RELEASE gibt eine Oracle GoldenGate-Releaseversionan. major ist die Hauptversionsnummer und minor die Nebenversionsnummer. X.x muss ein aktuelles oder vorheriges allgemein verfügbares Oracle GoldenGate-Release sein. Gültige Werte sind 11.1 bis zur aktuellen Oracle GoldenGate X.x-Versionsnummer, z.B. 11.2 oder 12.1. Die Releaseversion wird programmgesteuert der angemessenen Kompatibilitätsebene für das Trailformat zugeordnet. Der Standardwert ist die aktuelle Version des Prozesses, der Daten in diesen Trail schreibt. Hinweis: In RELEASE-Versionen vor 12.1 werden dreiteilige Objektnamen nicht unterstützt.

Hinweis: Wenn Sie mehrere Trails in einem Extract verwendet haben, können nur identische RELEASE-Versionen gemeinsam genutzt werden.

Die folgenden Einstellungen werden bei Oracle Database 12.2 und höher unterstützt:

• Bei Oracle Database 12.2 wird Nicht-CDB oder höhere mit Kompatibilität für 12.1, FORMAT RELEASE 12.2 oder höhere unterstützt.

• Bei Oracle Database 12.2 wird Nicht-CDB oder höhere mit Kompatibilität für 12.2, FORMAT RELEASE 12.2 oder höhere unterstützt.

• Bei Oracle Database 12.2 CDB/PDB oder höher mit Kompatibilität für 12.2 werden nur FORMAT RELEASE-Werte von 12.3 oder höher unterstützt. Grund dafür ist die Verwendung von lokalem Undo für PDBs, bei dem die Transaktions-ID ID durch die PDB-Nummer ergänzt wird muss, um die Eindeutigkeit von Transaktions-IDs sicherzustellen.

Beispiel

DEFSFILE ./dirdef/orcldef CHARSET ISO-8859-11 FORMAT RELEASE 11.2