SET_SESSION_CHARSET

Válido para

Extraer y Replicat

Descripción

Utilice la función SET_SESSION_CHARSET para definir el juego de caracteres de la salida de usuario. El juego de caracteres de la sesión de salida de usuario indica la codificación de cualquier miembro de la estructura de devolución de llamada basada en caracteres que se utilice entre la salida de usuario y el proceso de emisor de llamada (extracción, pump de datos, Replicat), incluidos metadatos como (pero no limitados a):

• Nombres y configuraciones regionales de la base de datos

• nombres de tabla y columna

• Texto DDL

• mensajes de error

• columnas de tipo de carácter, como CHAR y NCHAR

• columnas de fecha y hora y numéricas que se representan en formato de cadena

Esta función se puede llamar en cualquier momento en que la salida de usuario tenga control. Cuando la salida de usuario define el juego de caracteres de la sesión, se aplica inmediatamente y todos los valores de caracteres comienzan a convertirse al juego especificado. El lugar recomendado para llamar a esta función es con el tipo de llamada EXIT_CALL_START.

Nota: SET_SESSION_CHARSET no es seguro para threads.

Si no se llama a SET_SESSION_CHARSET, la sesión se define en el juego de caracteres por defecto del sistema operativo, que es un valor de tipo enumerado predefinido en ULIB_CS_DEFAULT en el archivo ucharset.h. Cuando el juego de caracteres de la sesión es un valor por defecto de ULIB_CS_DEFAULT, Oracle GoldenGate no realiza ninguna conversión para los valores de tipo de carácter que se intercambian entre la salida de usuario y el proceso de emisor de llamada. Además, los metadatos de nombre de objeto de la base de datos se consideran el juego de caracteres por defecto del sistema operativo. Tenga en cuenta que el valor por defecto puede no ser correcto.

El juego de caracteres de la salida de usuario se imprime en el archivo de informe cuando se carga la salida de usuario y cuando se llama a SET_SESSION_CHARSET. Si el juego de caracteres de la sesión es ULIB_CS_DEFAULT, aparece un mensaje que indica que no se está realizando ninguna conversión de juego de caracteres de datos de columna.

Sintaxis

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

Buffer

typedef struct
{
ULibCharSet  session_charset;
} session_def;

Entrada

<session_charset>

Los valores válidos del juego de caracteres de la sesión se definen en el archivo de cabecera ucharset.h.

Salida

Ninguno

Valores devueltos

EXIT_FN_RET_OK