EXTTRAIL

Durée de validité

Extraction

Description

Utilisez le paramètre EXTTRAIL pour indiquer une trace sur le système local créé à l'aide de la commande ADD EXTTRAIL. La trace est lue par un chemin de distribution ou par une réplication sur le système local.

EXTTRAIL doit précéder toutes les instructions TABLE associées. Plusieurs instructions EXTTRAIL peuvent être utilisées pour définir différentes traces pour une extraction, à l'exception d'une extraction MySQL lorsque le positionnement de l'ensemble GTID est utilisé car une seule trace est prise en charge.

A partir d'Oracle GoldenGate 19c, le processus Extract principal écrit les fichiers trace dans le même format que le format de fichier trace existant lors d'une mise à niveau, sauf si vous indiquez explicitement la version du format de fichier trace à l'aide de l'option FORMAT RELEASE. Cela empêche l'abandon des répliques suivantes si elles ne sont pas mises à niveau.

Vous pouvez crypter les données de cette trace à l'aide du paramètre ENCRYPTTRAIL. Pour plus d'informations, reportez-vous à "ENCRYPTTRAIL \| NOENCRYPTTRAIL".

Remarque : lorsque vous utilisez le paramètre ENCRYPTRAIL avec le paramètre EXTTRAIL, assurez-vous que le paramètre ENCRYPTRAIL est mentionné avant EXTTRAIL. Sinon, la trace ne sera pas cryptée.

Remarque : les traces locales devant être utilisées par un chemin de distribution envoyé à NSK, vous devez utiliser TRAILBYTEORDER BIGENDIAN. Cela ne peut pas être modifié dans le pompe de données.

Valeur par défaut

Aucun

Syntaxe

EXTTRAIL <file_name>
[, FORMAT RELEASE <major>.<minor>]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

<trail_name>

Nom de chemin qualifié complet ou relatif de la trace. Le nom de trace ne peut contenir que deux caractères.

Remarque : dans l'architecture de microservices, le préfixe à deux caractères de nom de fichier trace doit commencer par une lettre.

Oracle GoldenGate ajoute à la fin de ce nom un numéro de séquence à neuf chiffres chaque fois qu'un fichier est créé. Par exemple, une trace appelée /tr comporterait des fichiers nommés /tr000000001, /tr000000002.

FORMAT RELEASE <major.minor>

Valide pour une extraction. Indique le format de métadonnées des données envoyées par l'extraction vers une trace, un fichier ou (dans le cas d'une tâche distante) un autre processus. Les métadonnées indiquent au processus de lecture si la version des enregistrements de données est prise en charge. Le format de métadonnées dépend de la version du processus Oracle GoldenGate. Les anciennes versions d'Oracle GoldenGate ne contiennent pas les mêmes métadonnées que les plus récentes.

FORMAT RELEASE indique une version Oracle GoldenGate. major correspond au numéro d'une version majeure et minor au numéro d'une version mineure. Les valeurs major.minor doivent correspondre à une nouvelle version (release) de disponibilité générale actuelle ou antérieure d'Oracle GoldenGate. Les valeurs valides vont de 11,2 au numéro de version X.x d'Oracle GoldenGate en cours, par exemple 23.26 ou 19.1.

La version est mise en correspondance par programmation avec le niveau de compatibilité de format de trace approprié. La valeur par défaut est la version actuelle du processus écrivant dans la trace. Remarque : les versions RELEASE antérieures à 12.1 ne prennent pas en charge les noms d'objet en trois partis.

Remarque : en cas d'utilisation de plusieurs traces dans une seule extraction, seules les versions RELEASE identiques peuvent coexister.

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

Définit le format d'octets des fichiers trace. Valide uniquement pour les traces dont la version FORMAT RELEASE est au moins 12.1. Les valeurs valides sont BIGENDIAN (big endian), LITTLEENDIAN (little endian) et NATIVEENDIAN. La valeur par défaut est NATIVEENDIAN. Pour des instructions d'utilisation supplémentaires, reportez-vous à la version GLOBALS de TRAILBYTEORDER.

Exemples

Exemple 1

EXTTRAIL ny

Exemple 2

Sous Linux :

EXTTRAIL trails/ny, FORMAT RELEASE 12.3

Exemple 3

Sous Windows :

EXTTRAIL trails\ny, FORMAT RELEASE 12.3

Exemple 4

Deux formats de trace au sein des mêmes ensembles de tables capturées :

EXTTRAIL ea
TABLE hr.tab1
TABLE hr.tab2
EXTTRAIL eb
TABLE scott.tab3
TABLE scott.tab4