défgen

Remarque : veillez à définir les variables d'environnement comme décrit dans la section Programmes Oracle GoldenGate pour pouvoir utiliser l'utilitaire DEFGEN.

Utilisez l'utilitaire DEFGEN pour générer des définitions de métadonnées de table source, qui peuvent être utilisées par une réplication pour lire un fichier trace dans une version de format antérieure à Oracle GoldenGate 12.2 et qui ne contient pas de métadonnées de table source. Le logiciel DEFGEN est installé dans le répertoire de base Oracle GoldenGate, bin.

Syntaxe pour Windows, UNIX et Linux

defgen PARAMFILE <parameter_file>
[NOEXTATTR]
[PAUSEATEND | NOPAUSEATEND]
[REPORTFILE <report_file>]
[UPDATECS <characterset> ]

PARAMFILE <parameter_file>

Obligatoire. Spécifie le nom de chemin relatif ou absolu du fichier de paramètres pour le programme DEFGEN en cours d'exécution. Le fichier de paramètres doit être créé manuellement et répertoriera un fichier defs pour la sortie de définition de table, les informations de connexion à la base de données et les tables à générer.

NOEXTATTR

Peut être utilisé pour prendre en charge la compatibilité ascendante avec les versions d'Oracle GoldenGate antérieures à la version 11.2.1 et ne prenant pas en charge les jeux de caractères autres qu'ASCII, ni la sensibilité à la casse ou les noms d'objet entre guillemets avec des espaces. NOEXTATTR empêche DEFGEN d'inclure les paramètres régionaux et le jeu de caractères de la base de données qui prennent en charge les fonctionnalités de globalisation introduites dans Oracle GoldenGate version 11.2.1. Si le nom de la table ou de la colonne comporte des caractères spéciaux ou multioctets, tels que des espaces, DEFGEN n'inclut pas la définition de la table lorsque NOEXTATTR est spécifié. Si le mode APPEND est utilisé dans le fichier de paramètres, NOEXTATTR est ignoré et la nouvelle définition de table est ajoutée au format de fichier existant, qu'il s'agisse des attributs supplémentaires ou non.

PAUSEATEND

NOPAUSEATEND (par défaut)

(Windows uniquement) Lorsque le processus s'arrête, un utilisateur Oracle GoldenGate doit consulter la sortie de la console, puis appuyer sur une touche pour l'effacer. Indique également si le processus s'est terminé normalement ou anormalement.

REPORTFILE <report_file>

Envoie la sortie de la commande au fichier de rapport spécifié. Sans l'option reportfile, la sortie de la commande est affichée à l'écran.

defs_file UPDATECS <charset>

Convertit le jeu de caractères d'un fichier de définitions en un jeu de caractères différent si le fichier est transféré vers un système d'exploitation avec un jeu de caractères incompatible. Cette procédure prend le nom du fichier de définitions et du jeu de caractères ciblé en entrée. Par exemple : defgen source.def UPDATECS UTF-8.

UPDATECS aide dans des situations telles que lorsqu'un nom de table japonais sous Windows japonais est écrit sous Windows CP932 dans le fichier de définitions de données, puis que le fichier de définitions est transféré sous UNIX japonais. Le fichier ne peut être utilisé que si UNIX est configuré dans l'environnement linguistique PCK. Par conséquent, vous devez utiliser UPDATECS pour convertir le codage du fichier de définitions au format correct.

Exemple

Voici un exemple de fichier de paramètres DEFGEN, defgenparam.prm. Pour plus de détails, reportez-vous au paramètre DEFSFILE.

DEFSFILE /home/oracle/ogg/ora/bin/ora.defs, PURGE
USERIDALIAS oracle_source
TABLE hr.employees;

Pour exécuter le programme DEFGEN, utilisez la commande suivante :

$OGG_HOME/bin/defgen PARAMFILE defgenparam.prm