CUSEREXIT

Válido Para

Replicat

Descrição

Use o parâmetro CUSEREXIT para chamar uma rotina de saída personalizada gravada no código de programação C de um objeto compartilhado DLL ou UNIX do Windows em um ponto de saída definido no processamento do Oracle GoldenGate. Sua rotina de saída de usuário deve ser capaz de aceitar diferentes eventos e informações dos processos Replicat, processar as informações conforme desejado e retornar uma resposta e informações ao chamador (o processo do Oracle GoldenGate que as chamou).

As saídas do usuário podem ser usadas como uma alternativa ou em conjunto com as funções de transformação de dados disponíveis na solução Oracle GoldenGate.

Observação: ao usar um Replicat coordenado para chamar uma rotina de saída de usuário, você é responsável por gravar as saídas de usuário de maneira segura para thread.

Para obter ajuda sobre como criar e implementar saídas de usuário, consulte Usando Saídas de Usuário para Estender os Recursos do Oracle GoldenGate.

Padrão

Nenhum

Sintaxe

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

{<DLL> | <shared_object>}

O nome do objeto compartilhado DLL ou UNIX do Windows que contém a função de saída do usuário.

<routine>

O nome da rotina de saída a ser executada.

INCLUDEUPDATEBEFORES

Passa as imagens anteriores dos valores da coluna para uma saída de usuário. Ao usar esse parâmetro, você deve solicitar explicitamente a imagem anterior, definindo o flag requesting_before_after_ind como BEFORE_IMAGE_VAL em uma função de callback que suporte esse flag. Caso contrário, somente a imagem posterior será passada para a saída do usuário. Por padrão, o Oracle GoldenGate só funciona com imagens posteriores.

Ao usar INCLUDEUPDATEBEFORES para uma saída de usuário chamada do Replicat, sempre use o parâmetro GETUPDATEBEFORES para o processo de Extract tranlog, para que a imagem anterior seja gravada na trilha.

PARAMS <'string'>

Passa a string especificada na inicialização. Pode ser usado para passar um arquivo de propriedades, parâmetros de inicialização ou outra string. Coloque a string entre aspas simples.

Os dados na string são passados para a saída do usuário no EXIT_CALL_START exit_params_def.function_param. Se nenhuma string entre aspas for especificada com PARAMS, a exit_params_def.function_param será NULL.

Exemplos

Exemplo 1

CUSEREXIT userexit.dll MyUserExit

Exemplo 2

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

Exemplo 3

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

Exemplo 4

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

Exemplo 5

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