SET_SESSION_CHARSET

Durée de validité

Extraction et réplication

Description

Utilisez la fonction SET_SESSION_CHARSET pour définir le jeu de caractères de l'exit utilisateur. Le jeu de caractères de la session d'exit utilisateur indique le codage de tous les membres de structure de rappel basés sur des caractères qui sont utilisés entre l'exit utilisateur et le processus appelant (Extract, Data Pump, Replicat), y compris les métadonnées telles que (mais sans s'y limiter) :

• noms et environnements linguistiques de base de données

• noms de table et de colonne

• Texte DDL

• messages d'erreur

• colonnes de type caractère telles que CHAR et NCHAR

• colonnes date-heure et numériques représentées sous forme de chaîne

Cette fonction peut être appelée à tout moment que l'exit utilisateur a le contrôle. Lorsque l'exit utilisateur définit le jeu de caractères de session, il prend effet immédiatement et toutes les valeurs de caractères commencent à être converties dans le jeu spécifié. L'endroit recommandé pour appeler cette fonction est le type d'appel EXIT_CALL_START.

Remarque : SET_SESSION_CHARSET n'est pas sûr pour les threads.

Si SET_SESSION_CHARSET n'est pas appelé, la session est définie sur le jeu de caractères par défaut du système d'exploitation, qui est une valeur de type énumérée prédéfinie dans ULIB_CS_DEFAULT dans le fichier ucharset.h. Lorsque le jeu de caractères de session est une valeur par défaut de ULIB_CS_DEFAULT, aucune conversion n'est effectuée par Oracle GoldenGate pour les valeurs de type caractère échangées entre l'exit utilisateur et le processus appelant. En outre, les métadonnées de nom d'objet de la base de données sont considérées comme le jeu de caractères par défaut du système d'exploitation. Gardez à l'esprit que la valeur par défaut peut ne pas être correcte.

Le jeu de caractères de l'exit utilisateur est imprimé dans le fichier de rapport lorsque l'exit utilisateur est chargé et lorsque SET_SESSION_CHARSET est appelé. Si le jeu de caractères de session est ULIB_CS_DEFAULT, un message indique qu'aucune conversion de jeu de caractères de données de colonne n'est en cours.

Syntaxe

#include usrdecs.h
short result_code;
session_def session_charset_def;
ERCALLBACK (SET_SESSION_CHARSET, &session_charset_def, &result_code);

Tampon

typedef struct
{
ULibCharSet  session_charset;
} session_def;

Entrée

<session_charset>

Les valeurs valides du jeu de caractères de session sont définies dans le fichier d'en-tête ucharset.h.

Sortie

Aucun

Valeurs retournées

EXIT_FN_RET_OK