ADD EXTTRAIL

Utilisez ADD EXTTRAIL afin de créer une trace pour un traitement en ligne sur le système local et procédez aux actions suivantes :

Associez-la à un groupe d'extraction.
Affectez une taille maximale de fichier.
Lorsque vous tentez de créer plusieurs fichiers trace à l'aide de ADD EXTTRAIL, à partir d'un seul processus d'extraction, l'opération échoue si le nombre de fichiers trace dépasse une certaine limite. Plus précisément, lorsque plus de 12 traces sont créées, l'erreur suivante peut se produire :
```
2025-11-05T21:16:04Z  INFO    OGG-08100  Exceeded checkpoint record size (32,768/32,767) in

checkpoint file /path/to/checkpoint/file.cpe.
```
Cette erreur se produit car le fichier de point de reprise dépasse la limite de taille de 32 767 enregistrements. Le fichier de point de reprise contient le CSN (numéro de séquence de validation), le XID (ID transaction) et les numéros d'enregistrement, qui contribuent à la taille du fichier.

Pour éviter cette erreur, il est recommandé de ne pas créer plusieurs fichiers trace à partir d'un seul processus Extract, en particulier pour des raisons de performances. L'approche privilégiée consiste à ce qu'une seule extraction capture toutes les données requises et utilise le service de distribution pour les distribuer à différentes destinations.

Une autre option consiste à exécuter plusieurs processus Extract si la taille du fichier trace doit être réduite pour chaque destination.

Reportez-vous à EXTTRAIL dans Référence des paramètres et des fonctions pour Oracle GoldenGate

Syntaxe

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

trail_name

Nom de trace à deux caractères. Il est recommandé que les deux caractères soient des lettres, mais le premier caractère ne doit pas être un nombre. Oracle GoldenGate ajoute à la fin de ce nom un numéro de séquence à neuf chiffres chaque fois qu'un fichier est créé.

Le nom de trace peut également être précédé d'un répertoire. Par exemple, une trace appelée north/ea comporterait des fichiers trace nommés ea000000000, ea000000001 dans le sous-répertoire $OGG_DATA_HOME/north.

group_name

Nom du groupe d'extraction auquel la trace est liée. Une trace peut uniquement être affectée à une extraction. Plusieurs extractions ne peuvent pas écrire sur la même trace. En revanche, une extraction peut écrire sur plusieurs traces distinctes si nécessaire mais en principe, une telle opération n'est pas requise.

MEGABYTES n

Taille maximale, en méga-octets, de chaque fichier trace de la séquence. La valeur par défaut est 500 Mo et la valeur maximale, 2 000 Mo.

SEQNO n

Spécifie que le premier fichier de la trace commencera par le numéro de séquence de trace indiqué. N'incluez pas de remplissage par des zéros. Par exemple, pour commencer à cette séquence 3 d'une trace nommée tr, indiquez SEQNO 3. Le fichier proprement dit serait nommé /ea000000003. Cette option peut être utilisée lors du dépannage lorsqu'une réplication doit être repositionnée sur un numéro de séquence d'historique donné. Elle permet de ne pas avoir à modifier la réplication pour lire le numéro d'ordre requis. La valeur par défaut est 1.

Limites

Lors de la création d'une trace d'extraction portant le même nom qu'une trace d'extraction précédente, assurez-vous que toutes les traces de ce répertoire avec le même trail_name ont été supprimées.

Lors d'une capture à partir d'une base de données MySQL activée pour la réplication de groupe, une seule trace est autorisée pour une extraction.

Exemples

La commande suivante crée une trace nommée ea :

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

La sortie est affichée comme suit :

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