CUSTODIA

Válido para

Replicat

Descripción

Utilice el parámetro CUSEREXIT para llamar a una rutina de salida personalizada escrita en el código de programación C desde un objeto compartido de UNIX o DLL de Windows en un punto de salida definido en el procesamiento de Oracle GoldenGate. La rutina de salida de usuario debe poder aceptar diferentes eventos e información de los procesos de Replicat, procesar la información como desee y, a continuación, devolver una respuesta e información al emisor de llamada (el proceso de Oracle GoldenGate que la llamó).

Las salidas de usuario se pueden utilizar como alternativa a las funciones de transformación de datos disponibles en la solución Oracle GoldenGate o junto con ellas.

Nota: Al utilizar un Replicat coordinado para llamar a una rutina de salida de usuario, usted es responsable de escribir las salidas de usuario de forma segura.

Para obtener ayuda sobre la creación e implantación de salidas de usuario, consulte Uso de salidas de usuario para ampliar las capacidades de Oracle GoldenGate.

Valor por defecto

Ninguno

Sintaxis

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

{<DLL> | <shared_object>}

Nombre del objeto compartido de UNIX o DLL de Windows que contiene la función de salida de usuario.

<routine>

Nombre de la rutina de salida que se va a ejecutar.

INCLUDEUPDATEBEFORES

Transfiere las imágenes de valores de columna antes de una salida de usuario. Al utilizar este parámetro, debe solicitar explícitamente la imagen anterior definiendo el indicador requesting_before_after_ind en BEFORE_IMAGE_VAL dentro de una función de devolución de llamada que soporte este indicador. De lo contrario, solo se transfiere la imagen posterior a la salida de usuario. Por defecto, Oracle GoldenGate solo funciona con imágenes posteriores.

Al utilizar INCLUDEUPDATEBEFORES para una salida de usuario que se llama desde Replicat, utilice siempre el parámetro GETUPDATEBEFORES para el proceso de extracción de tranlog, de modo que la imagen anterior se escriba en la pista.

PARAMS <'string'>

Transfiere la cadena especificada en el inicio. Se puede utilizar para transferir un archivo de propiedades, parámetros de inicio u otra cadena. Incluya la cadena entre comillas simples.

Los datos de la cadena se transfieren a la salida de usuario en EXIT_CALL_START exit_params_def.function_param. Si no se especifica ninguna cadena entre comillas con PARAMS, exit_params_def.function_param es NULL.

Ejemplos

Ejemplo 1

CUSEREXIT userexit.dll MyUserExit

Ejemplo 2

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

Ejemplo 3

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

Ejemplo 4

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

Ejemplo 5

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