PROGRAMME UTILISATEUR

Durée de validité

Réplication

Description

Utilisez le paramètre CUSEREXIT pour appeler une routine de sortie personnalisée écrite en code de programmation C à partir d'une DLL Windows ou d'un objet partagé UNIX à un point de sortie défini dans le traitement Oracle GoldenGate. La routine d'exit utilisateur doit pouvoir accepter différents événements et informations des processus Replicat, traiter les informations selon vos besoins, puis renvoyer une réponse et des informations à l'appelant (processus Oracle GoldenGate qui l'a appelée).

Les user exits peuvent être utilisés comme alternative aux fonctions de transformation de données disponibles dans la solution Oracle GoldenGate ou en association avec celles-ci.

Remarque : Lors de l'utilisation d'une réplication coordonnée pour appeler une routine d'exit utilisateur, vous êtes responsable de l'écriture des exits utilisateur en toute sécurité.

Pour obtenir de l'aide sur la création et l'implémentation des exits utilisateur, reportez-vous à Utilisation des exits utilisateur pour étendre les fonctionnalités Oracle GoldenGate.

Valeur par défaut

Aucun

Syntaxe

CUSEREXIT {<DLL> | <shared_object>} <routine>
[, INCLUDEUPDATEBEFORES]
[, PARAMS '<string>']

{<DLL> | <shared_object>}

Nom de la DLL Windows ou de l'objet partagé UNIX qui contient la fonction d'exit utilisateur.

<routine>

Nom de la routine de sortie à exécuter.

INCLUDEUPDATEBEFORES

Transmet les images des valeurs de colonne avant à une sortie utilisateur. Lorsque vous utilisez ce paramètre, vous devez demander explicitement l'image "avant" en définissant l'indicateur requesting_before_after_ind sur BEFORE_IMAGE_VAL dans une fonction de callback qui prend en charge cet indicateur. Sinon, seule l'image after est transmise à l'exit utilisateur. Par défaut, Oracle GoldenGate ne fonctionne qu'avec les images after.

Lorsque vous utilisez INCLUDEUPDATEBEFORES pour un user exit appelé à partir du processus Replicat, utilisez toujours le paramètre GETUPDATEBEFORES pour le processus d'extraction tranlog, de sorte que l'image before soit écrite dans la trace.

PARAMS <'string'>

Transmet la chaîne spécifiée au démarrage. Peut être utilisé pour transmettre un fichier de propriétés, des paramètres de démarrage ou une autre chaîne. Placez la chaîne entre apostrophes.

Les données de la chaîne sont transmises à l'exit utilisateur dans le fichier EXIT_CALL_START exit_params_def.function_param. Si aucune chaîne entre guillemets n'est indiquée avec PARAMS, exit_params_def.function_param est NULL.

Exemples

Exemple 1

CUSEREXIT userexit.dll MyUserExit

Exemple 2

CUSEREXIT userexit.dll MyUserExit, PARAMS 'init.properties'

Exemple 3

CUSEREXIT userexit.dll MyUserExit, INCLUDEUPDATEBEFORES, PARAMS 'init.properties'

Exemple 4

CUSEREXIT userexit.dll MyUserExit, INCLUDEUPDATEBEFORES, &
  PARAMS 'init.properties'

Exemple 5

CUSEREXIT cuserexit.dll MyUserExit, &
  INCLUDEUPDATEBEFORES, PARAMS 'Some text to start with during startup'