SETENV

Durée de validité

Extraction et réplication.

Toutes les valeurs SETENV doivent être définies avant les entrées USERIDALIAS, FETCHUSERIDALIAS, TRANLOGOPTIONS MININGUSER et MININGUSERIDALIAS des fichiers de paramètres.

Description

Utilisez le paramètre SETENV pour définir une valeur pour une variable d'environnement. Lorsque le processus Extract ou Replicat démarre, il utilise la valeur indiquée au lieu de celle définie dans l'environnement du système d'exploitation. Une variable définie dans l'instruction SETENV remplace toutes les variables existantes définies au niveau du système d'exploitation. Utilisez une instruction SETENV par variable à définir.

Pour les extractions intégrées, vous pouvez définir de nouvelles variables d'environnement si elles sont disponibles à partir du serveur lcr. Les nouvelles variables d'environnement sont :

• USERNAME : nom utilisateur de connexion à la base de données

• OSUSERNAME : nom utilisateur de système d'exploitation

• MACHINENAME : nom de l'hôte, de l'ordinateur ou du serveur sur lequel la base de données est exécutée.

• PROGRAMNAME : nom du programme ou de l'application qui a démarré la transaction ou la session

• CLIENTIDENTIFIER : jeu de valeurs utilisant DBMS_SESSION.set_identifier()

SETENV ne peut pas être utilisé avec les paramètres de requête.

Valeur par défaut

Aucun

Syntaxe

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

<environment_variable>

Nom de la variable d'environnement à définir.

TZ

(MySQL uniquement) Lors de l'exécution d'Oracle GoldenGate pour MySQL sur un serveur Windows ou sur un serveur Linux (pour la version OGG inférieure à 23.10.x) qui se trouve sur un hôte distant à partir du serveur de base de données, utilisez le paramètre SETENV dans le fichier de paramètres d'extraction pour définir le fuseau horaire afin qu'il corresponde à celui du serveur de base de données. Le format des valeurs de fuseau horaire pris en charge pour l'option TZ est le suivant :

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).

Le décalage est positif si le fuseau horaire local est à l'ouest du Méridien Premier et négatif s'il est Est. L'heure doit être comprise entre 0 et 24, et la minute et les secondes entre 0 et 59.

<'value'>

Valeur de la variable indiquée. Placez la valeur entre apostrophes.

Exemples

Exemple 1

L'utilisation d'instructions SETENV distinctes permet à une instance unique d'Oracle GoldenGate de se connecter à plusieurs instances Oracle AI Database sans avoir à modifier les paramètres d'environnement. Les instructions de paramètre suivantes définissent une valeur pour ORACLE_HOME et ORACLE_SID.

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

Exemple 2

L'instruction de paramètre suivante définit le fuseau horaire d'une instance Oracle GoldenGate pour l'extraction MySQL vers l'heure standard du Pacifique, UTC ou IST avec commutation automatique de l'heure d'été.

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