FICHIER EXTERNE

Durée de validité

Extraction et réplication

Description

Utilisez le paramètre EXTFILE pour indiquer un fichier d'extraction sur le système local qui sera créé par une extraction de chargement initial et lu par un processus Replicat de chargement initial lorsque SPECIALRUN sera utilisé.

Utilisez ce paramètre pour les configurations de chargement initial. Pour la synchronisation des modifications en ligne, utilisez le paramètre EXTTRAIL.

EXTFILE doit précéder toutes les instructions TABLE ou MAP associées. Plusieurs instructions EXTFILE peuvent être utilisées pour définir différents fichiers.

Le processus Replicat prend uniquement en charge la valeur file_name et aucune option.

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

Valeur par défaut

Aucun

Syntaxe

EXTFILE <file_name>
[ APPEND]
[, PURGE]
[, FORMAT RELEASE <major>.<minor>]
[, MEGABYTES <megabytes>]
[, OBJECTDEFS]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

<file_name>

Nom relatif ou complet de la trace. Utilisez seulement deux caractères pour le nom de trace. Si vous utilisez plus de deux caractères, le fichier sera créé avec ce nom, mais sans numéro de séquence. A mesure que les fichiers trace sont vieillis, un numéro de séquence de six caractères est ajouté à ce nom, par exemple /ogg/dirdat/ef000001. Si vous utilisez FORMAT RELEASE 12.2 ou une version antérieure, le fichier trace créé est un fichier statique qui n'est pas incrémenté et la convention de dénomination n'est pas limitée à deux caractères.

APPEND

Ajoute les données actuelles aux données existantes du fichier. Si vous utilisez APPEND, n'utilisez pas PURGE.

PURGE

Supprime un fichier existant avant d'en créer un nouveau. Si vous utilisez PURGE, n'utilisez pas APPEND.

FORMAT RELEASE <major.minor>

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. X.x doit correspondre à une version (release) de disponibilité générale actuelle ou antérieure d'Oracle GoldenGate. Les valeurs valides sont comprises entre 12.2 et le numéro de version X.x d'Oracle GoldenGate actuel, par exemple 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.2 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.

Les paramètres suivants sont pris en charge pour Oracle Database version 12.2 ou supérieure :

• Pour une base de données non Conteneur Oracle Database 12.2 ou supérieure avec une compatibilité définie sur 12.1 ou supérieure, FORMAT RELEASE 12.2 ou supérieure est pris en charge, en raison de la valeur SCN supérieure.

• Pour Oracle Database 12.2 CDB/PDB ou version ultérieure avec une compatibilité définie sur 12.2 ou version ultérieure, seules les valeurs FORMAT RELEASE 12.3 ou version ultérieure sont prises en charge. Cela est dû à l'utilisation de l'annulation locale pour les bases de données pluggables, qui nécessite d'augmenter la transaction ID avec le numéro de la base de données pluggable pour garantir l'unicité des ID de transaction.

MEGABYTES <megabytes>

Taille maximale, en méga-octets, d'un fichier dans la trace. La valeur par défaut est 2000.

OBJECTDEFS

Utilisez l'option OBJECTDEFS pour inclure les définitions d'objet dans la trace. Cette option est applicable uniquement lorsque la trace de sortie est formatée au format canonique Oracle GoldenGate et que la version du format de trace est supérieure à 12.2. Sinon, cette option est ignorée car aucun enregistrement de métadonnées ne sera ajouté à la trace.

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

Définit le format d'octets des fichiers trace. Valide uniquement pour les fichiers trace dont la version FORMAT RELEASE est au moins 12.2. 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

EXTFILE dirdat/ef

Exemple 2

EXTFILE dirdat/ef, MEGABYTES 200

Exemple 3

EXTFILE /ggs/dirdat/extdat, FORMAT RELEASE 18.1