ADD EXTTRAIL

Verwenden Sie ADD EXTTRAIL, um einen Trail für eine Onlineverarbeitung auf dem lokalen System zu erstellen und folgende Aktionen auszuführen:

• Den Trail mit einer Extract-Gruppe verknüpfen

• Eine maximale Dateigröße zuweisen

• Wenn Sie versuchen, mehrere Traildateien mit ADD EXTTRAIL aus einem einzelnen Extract-Prozess zu erstellen, verläuft der Vorgang nicht erfolgreich, wenn die Anzahl der Traildateien ein bestimmtes Limit überschreitet. Wenn mehr als 12 Trails erstellt werden, kann der folgende Fehler auftreten:

  2025-11-05T21:16:04Z  INFO    OGG-08100  Exceeded checkpoint record size (32,768/32,767) in
  
  checkpoint file /path/to/checkpoint/file.cpe.

  Dieser Fehler tritt auf, weil die Checkpoint-Datei die Größenbeschränkung von 32.767 Datensätzen überschreitet. Die Checkpoint-Datei enthält CSN (Commit Sequence Number), XID (Transaction ID) und Datensatznummern, die zur Größe der Datei beitragen.

  Um diesen Fehler zu vermeiden, wird empfohlen, nicht mehrere Traildateien aus einem einzelnen Extract zu erstellen, insbesondere aus Performancegründen. Der bevorzugte Ansatz besteht darin, alle erforderlichen Daten mit einem einzigen Extract zu erfassen und den Distribution Service zu verwenden, um sie an verschiedene Ziele zu verteilen.

  Eine weitere Alternative besteht darin, mehrere Extract-Prozesse auszuführen, wenn die Traildateigröße für jedes einzelne Ziel reduziert werden muss.

Siehe EXTTRAIL in der Referenz zu Parametern und Funktionen für Oracle GoldenGate

Syntax

ADD EXTTRAIL trail_name, EXTRACT group_name
[, MEGABYTES n]
[SEQNO n]

trail_name

Ein aus zwei Zeichen bestehender Trailname. Es wird empfohlen, dass beide Zeichen Buchstaben sind, das erste Zeichen jedoch keine Zahl sein darf. Oracle GoldenGate hängt eine neunstellige Sequenznummer an diesen Namen an, wenn eine neue Datei erstellt wird.

Dem Trailnamen kann auch ein Verzeichnis vorangestellt werden. Beispiel: Der Trail north/ea hätte Traildateien namens ea000000000, ea000000001 im Unterverzeichnis $OGG_DATA_HOME/north.

group_name

Der Name der Extract-Gruppe, an die der Trail gebunden ist. Ein Trail kann nur einem Extract zugewiesen werden. Mehrere Extracts können nicht in denselben Trail schreiben. Ein Extract kann jedoch in mehrere unterschiedliche Trails schreiben. Das ist normalerweise aber nicht erforderlich.

MEGABYTES n

Die maximale Größe (in Megabyte) jeder Traildatei in der Sequenz. Der Standardwert ist 500 MB und der Höchstwert 2000 MB.

SEQNO n

Gibt an, dass die erste Datei im Trail mit der angegebenen Trailsequenznummer beginnt. Verwenden Sie kein Null-Padding. Beispiel: Um bei Sequenz 3 des Trails tr zu beginnen, geben Sie SEQNO 3 an. Der tatsächliche Dateiname wäre dann /ea000000003. Diese Option kann bei der Fehlerbehebung verwendet werden, wenn Replicat bei einer bestimmten Trailsequenznummer neu positioniert werden muss. So müssen Sie Replicat nicht mehr so ändern, dass die erforderliche Sequenznummer gelesen wird. Der Standardwert lautet 1.

Einschränkungen

Wenn Sie einen Extract-Trail mit demselben Namen wie einen vorherigen Extract-Trail erstellen, stellen Sie sicher, dass alle Trails in diesem Verzeichnis mit demselben trail_name gelöscht wurden.

Bei der Erfassung aus einer MySQL-Datenbank mit aktivierter Gruppenreplikation ist nur ein Trail für Extract zulässig.

Beispiele

---

Der folgende Befehl erstellt den Trailnamen ea:

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

Die Ausgabe sieht folgendermaßen aus:

2019-11-20T23:49:19Z  INFO    OGG-08100  EXTTRAIL added.