FICHIER DE DÉFINITIONS

Durée de validité

DEFGEN

Description

Utilisez le paramètre DEFSFILE pour identifier le nom du fichier dans lequel DEFGEN écrira les définitions de données. Par défaut, le fichier de définitions de données est écrit dans le jeu de caractères du système d'exploitation local. Vous pouvez modifier le jeu de caractères à l'aide de l'option CHARSET.

Valeur par défaut

Aucun

Syntaxe

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

<file_name>

Nom de fichier relatif ou complet. Le fichier est créé lorsque vous exécutez DEFGEN.

APPEND

Indique à DEFGEN d'écrire un nouveau contenu (à partir de l'exécution en cours) à la fin de tout contenu existant, si le fichier spécifié existe déjà. Si le fichier de définitions existe déjà, mais qu'il est d'une version antérieure d'Oracle GoldenGate, vous pouvez définir l'option FORMAT RELEASE sur la même version que le fichier existant pour éviter les erreurs. Sinon, DEFGEN tentera d'ajouter des fonctionnalités de métadonnées plus récentes et abandonnera. Les restrictions suivantes s'appliquent lors de l'utilisation de APPEND :

Si le format du fichier de définitions de données existant est antérieur à Oracle GoldenGate 11.2.1, DEFGEN ajoute les définitions de table dans l'ancien format, où les noms de table et de colonne comportant plusieurs octets et des caractères spéciaux ne sont pas pris en charge.
Si le fichier de définitions de données existant est au format le plus récent introduit dans la version 11.2.1, DEFGEN ajoute les définitions de table dans le jeu de caractères existant du fichier.
Si le fichier existant provient de la version 11.2 ou antérieure, il a été écrit lorsque DEFGEN ne prenait pas en charge les noms d'objet en trois parties et génère une erreur si les nouvelles métadonnées contiennent des noms en trois parties. Vous pouvez indiquer des objets d'une base de données Conteneur Oracle si vous enlevez la partie de conteneur ou de catalogue à l'aide du paramètre NOCATALOG dans le fichier de paramètres DEFGEN.

PURGE

Indique à DEFGEN de purger le fichier indiqué avant d'écrire un nouveau contenu à partir de l'exécution en cours. Lorsque vous utilisez PURGE, vous pouvez remplacer un fichier de définitions existant qui a été créé par une ancienne version de DEFGEN par des métadonnées plus récentes qui prennent en charge des fonctionnalités plus récentes, telles que les noms d'objet en trois parties.

CHARSET <character_set>

Génère le fichier de définitions dans le jeu de caractères spécifié. Sans CHARSET, le jeu de caractères par défaut du système d'exploitation est utilisé. Si le mode APPEND est indiqué pour un fichier de définitions de version 11.2.1 ou ultérieure, CHARSET est ignoré et le jeu de caractères du fichier de définitions existant est utilisé.

FORMAT RELEASE <major.minor>

Indique le format de métadonnées des définitions envoyées par DEFGEN au fichier de définitions. Les métadonnées indiquent au processus de lecture si les enregistrements de fichier sont d'une version 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. Utilisez FORMAT lorsque le fichier de définitions sera utilisé par un processus dont la version d'Oracle GoldenGate est antérieure à la version en cours.

FORMAT est un mot-clé requis.
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 versions (release) de disponibilité générale actuelle ou antérieure d'Oracle GoldenGate. Les valeurs valides vont de 9.0 au numéro de version X.x d'Oracle GoldenGate en cours, par exemple 11.2 ou 12.1. (Si vous utilisez une version d'Oracle GoldenGate antérieure à la version 9.0, indiquez 9.0 ou 9.5.)

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

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 11.1 et le numéro de version X.x d'Oracle GoldenGate en cours, par exemple 11.2 ou 12.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.

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, FORMAT RELEASE 12.2 ou supérieure est pris en charge.
Pour la base de données non Conteneur Oracle Database 12.2 ou une version supérieure dont la compatibilité est définie sur 12.2, FORMAT RELEASE 12.2 ou une version supérieure est prise en charge.
Pour Oracle Database 12.2 CDB/PDB ou version ultérieure avec une compatibilité définie sur 12.2, 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.

Exemple

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