CUSEREXIT

Gültig für

Replicat

Beschreibung

Verwenden Sie den Parameter CUSEREXIT, um eine benutzerdefinierte Exit-Routine aufzurufen, die in C-Programmiercode von einem gemeinsam verwendeten Windows-DLL- oder UNIX-Objekt an einem definierten Exitpunkt innerhalb der Oracle GoldenGate-Verarbeitung geschrieben wurde. Ihre Routine zum Beenden von Benutzern muss in der Lage sein, verschiedene Ereignisse und Informationen aus den Replicat-Prozessen zu akzeptieren, die Informationen wie gewünscht zu verarbeiten und dann eine Antwort und Informationen an den Aufrufer (den Oracle GoldenGate-Prozess, der sie aufgerufen hat) zurückzugeben.

User Exits können als Alternative zu oder in Verbindung mit den Datentransformationsfunktionen verwendet werden, die in der Oracle GoldenGate-Lösung verfügbar sind.

Hinweis: Wenn Sie ein koordiniertes Replicat verwenden, um eine User Exit-Routine aufzurufen, sind Sie dafür verantwortlich, die User Exits Thread-sicher zu schreiben.

Hilfe zum Erstellen und Implementieren von User Exits finden Sie unter Oracle GoldenGate-Funktionen mit User Exits erweitern.

Standard

Keine

Syntax

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

{<DLL> | <shared_object>}

Der Name des gemeinsam verwendeten Windows DLL- oder UNIX-Objekts, das die User Exit-Funktion enthält.

<routine>

Der Name der auszuführenden Exit-Routine.

INCLUDEUPDATEBEFORES

Übergibt die Vorher-Bilder von Spaltenwerten an einen User Exit. Wenn Sie diesen Parameter verwenden, müssen Sie das Before Image explizit anfordern, indem Sie das Flag requesting_before_after_ind in einer Callback-Funktion, die dieses Flag unterstützt, auf BEFORE_IMAGE_VAL setzen. Andernfalls wird nur das After Image an den User Exit übergeben. Standardmäßig funktioniert Oracle GoldenGate nur mit After Images.

Wenn Sie INCLUDEUPDATEBEFORES für einen User Exit verwenden, der von Replicat aufgerufen wird, verwenden Sie immer den Parameter GETUPDATEBEFORES für den tranlog Extract-Prozess, damit das Before Image in den Trail geschrieben wird.

PARAMS <'string'>

Übergibt die angegebene Zeichenfolge beim Hochfahren. Kann verwendet werden, um eine Eigenschaftendatei, Startparameter oder eine andere Zeichenfolge zu übergeben. Setzen Sie die Zeichenfolge in einfache Anführungszeichen.

Daten in der Zeichenfolge werden an den User Exit in EXIT_CALL_START exit_params_def.function_param übergeben. Wenn keine Zeichenfolge in Anführungszeichen mit PARAMS angegeben wird, lautet exit_params_def.function_param NULL.

Beispiele

Beispiel 1

CUSEREXIT userexit.dll MyUserExit

Beispiel 2

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

Beispiel 3

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

Beispiel 4

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

Beispiel 5

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