SET_RECORD_BUFFER

Durée de validité

Extraction et réplication

Description

Utilisez la fonction SET_RECORD_BUFFER pour assurer la compatibilité avec les exits utilisateur et pour manipuler des enregistrements de données complexes. Cette fonction manipule l'ensemble de l'enregistrement. Il est préférable de modifier des valeurs de colonne individuelles plutôt que l'ensemble de l'enregistrement, car les formats d'enregistrement internes d'Oracle GoldenGate doivent être connus pour pouvoir modifier directement le tampon d'enregistrement de données. Pour modifier les valeurs de colonne, utilisez les fonctions SET_COLUMN_VALUE_BY_INDEX et SET_COLUMN_VALUE_BY_NAME. Ces fonctions sont suffisantes pour gérer la plupart des mappages personnalisés au sein d'un user exit.

Syntaxe

#include "usrdecs.h"
short result_code;
record_def record;
ERCALLBACK (SET_RECORD_BUFFER, &record_def, &result_code);

Tampon

typedef struct
{
char *table_name;
char *buffer;
long length;
char before_after_ind;
short io_type;
short record_type;
short transaction_ind;
int64_t timestamp;
exit_ts_str io_datetime;
short mapped;
short source_or_target;
/* Version 2 CALLBACK_STRUCT_VERSION   */
char requesting_before_after_ind;
} record_def;

Entrée

<buffer>

Pointeur vers le nouveau tampon d'enregistrement. En général, buffer est un pointeur vers un tampon de type exit_rec_buf_def. Le tampon exit_rec_buf_def contient l'enregistrement réel sur le point d'être traité par le processus d'extraction ou de réplication. Le tampon est fourni lorsque le type d'appel est EXIT_CALL_DISCARD_RECORD. Les routines de sortie peuvent modifier le contenu de cette mémoire tampon, par exemple pour exécuter des fonctions de mapping personnalisées.

Le contenu du tampon d'enregistrement n'est pas converti dans ou depuis le jeu de caractères de l'exit utilisateur. Il est transmis tel quel.

<length>

Nouvelle longueur du tampon d'enregistrement.

Sortie

Aucun

Valeurs retournées

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK
EXIT_FN_RET_NOT_SUPPORTED