CUSEREXIT

Valido per

Replicat

Descrizione

Utilizzare il parametro CUSEREXIT per richiamare una routine di uscita personalizzata scritta nel codice di programmazione C da un oggetto condiviso DLL o UNIX Windows in un punto di uscita definito all'interno dell'elaborazione di Oracle GoldenGate. La routine di uscita utente deve essere in grado di accettare eventi e informazioni diversi dai processi Replicat, elaborare le informazioni come desiderato, quindi restituire una risposta e informazioni al chiamante (il processo Oracle GoldenGate che le ha richiamate).

Le uscite utente possono essere utilizzate come alternativa o insieme alle funzioni di trasformazione dei dati disponibili nella soluzione Oracle GoldenGate.

Nota: Quando si utilizza un Replicat coordinato per chiamare una routine di user exit, si è responsabili per la scrittura dell'utente esce in modo thread-safe.

Per informazioni sulla creazione e l'implementazione delle user exit, vedere Uso delle user exit per estendere le funzionalità di Oracle GoldenGate.

Predefinito

Nessuno

Sintassi

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

{<DLL> | <shared_object>}

Il nome dell'oggetto condiviso DLL o UNIX di Windows contenente la funzione user exit.

<routine>

Nome della routine di uscita da eseguire.

INCLUDEUPDATEBEFORES

Passa le immagini precedenti ai valori di colonna a una routine di uscita utente. Quando si utilizza questo parametro, è necessario richiedere in modo esplicito l'immagine precedente impostando il flag requesting_before_after_ind su BEFORE_IMAGE_VAL all'interno di una funzione di callback che supporta questo flag. In caso contrario, solo l'immagine successiva viene passata all'uscita utente. Per impostazione predefinita, Oracle GoldenGate funziona solo dopo le immagini.

Quando si utilizza INCLUDEUPDATEBEFORES per un'uscita utente chiamata da Replicat, utilizzare sempre il parametro GETUPDATEBEFORES per il processo di estrazione tranlog, in modo che l'immagine precedente venga scritta nel trail.

PARAMS <'string'>

Passa la stringa specificata all'avvio. Può essere utilizzato per passare un file delle proprietà, parametri di avvio o altra stringa. Racchiudere la stringa tra apici.

I dati nella stringa vengono passati all'uscita utente nel file EXIT_CALL_START exit_params_def.function_param. Se non viene specificata alcuna stringa tra virgolette con PARAMS, exit_params_def.function_param è NULL.

Esempi

Esempio 1

CUSEREXIT userexit.dll MyUserExit

Esempio 2

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

Esempio 3

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

Esempio 4

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

Esempio 5

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