CONFIGURACIÓN

Válido para

Extracción y Replicat.

Los valores SETENV se deben definir antes que cualquier entrada USERIDALIAS, FETCHUSERIDALIAS, TRANLOGOPTIONS MININGUSER, MININGUSERIDALIAS en los archivos de parámetros.

Descripción

Utilice el parámetro SETENV para definir un valor para una variable de entorno. Cuando se inicia Extract o Replicat, utiliza el valor especificado en lugar del definido en el entorno del sistema operativo. Una variable definida en la sentencia SETENV sustituye cualquier variable existente definida en el nivel del sistema operativo. Utilice una sentencia SETENV por variable que definir.

Para las extracciones integradas, puede definir nuevas variables de entorno si están disponibles en el servidor lcr. Las nuevas variables de entorno son:

• USERNAME: nombre de usuario de conexión a la base de datos

• OSUSERNAME: nombre de usuario del sistema operativo

• MACHINENAME: nombre del host, máquina o servidor en el que se ejecuta la base de datos

• PROGRAMNAME: nombre del programa o aplicación que ha iniciado la transacción o sesión

• CLIENTIDENTIFIER: juego de valores con DBMS_SESSION.set_identifier()

SETENV no se puede utilizar con parámetros de consulta.

Valor por defecto

Ninguno

Sintaxis

SETENV (
{<environment_variable> | TZ}
= '<value>'
)

<environment_variable>

Nombre de la variable del entorno que se va a definir.

TZ

(Solo MySQL) Al ejecutar Oracle GoldenGate para MySQL en un servidor Windows o en un servidor Linux (para una versión de OGG inferior a 23.10.x) que está en un host remoto desde el servidor de base de datos, utilice el parámetro SETENV del archivo de parámetros Extract para definir la zona horaria para que coincida con la del servidor de base de datos. A continuación se muestra el formato admitido de los valores de zona horaria para la opción TZ:

SETENV(TZ='tzn [+|-]hh[:mm[:ss]][dzn]')

tzn - Three-letter time-zone name, such as PST. You must specify the correct offset from local time to UTC.
hh - Difference in hours between UTC and local time. Sign (+) optional for positive values.
mm - Minutes. Separated from hh by a colon (:).
ss - Seconds. Separated from mm by a colon (:).
dzn - Three-letter daylight-saving-time zone such as PDT.
If daylight saving time is never in effect in the locality, set TZ without a value for dzn. The C run-time
library assumes the United States' rules for implementing the calculation of daylight saving time (DST).

El desfase es positivo si la zona horaria local está al oeste del primer meridiano y negativo si está al este. La hora debe estar entre 0 y 24, y el minuto y los segundos entre 0 y 59.

<'value'>

Un valor para la variable especificada. Incluya el valor entre comillas simples.

Ejemplos

Ejemplo 1

El uso de sentencias SETENV independientes permite que una única instancia de Oracle GoldenGate se conecte a varias instancias de Oracle AI Database sin tener que cambiar la configuración del entorno. Las siguientes sentencias de parámetros definen un valor para ORACLE_HOME y ORACLE_SID.

SETENV (ORACLE_HOME = '/home/oracle/ora9/product')
SETENV (ORACLE_SID = 'ora9')

Ejemplo 2

La siguiente sentencia de parámetro define la zona horaria de una instancia de Oracle GoldenGate para MySQL Extract en la hora estándar del Pacífico, UTC o IST con el cambio automático de DST.

SETENV(TZ='PST8PDT')
For UTC, SETENV(TZ='UTC')
For IST, SETENV(TZ='IST-05:30')