SETENV

Gültig für

Extrahieren und Replicat

Alle SETENV-Werte müssen vor den Einträgen USERIDALIAS, FETCHUSERIDALIAS, TRANLOGOPTIONS MININGUSER und MININGUSERIDALIAS in den Parameterdateien festgelegt werden.

Beschreibung

Verwenden Sie den Parameter SETENV, um einen Wert für eine Umgebungsvariable festzulegen. Beim Start von Extract oder Replicat wird der angegebene Wert anstelle des Wertes verwendet, der in der Betriebssystemumgebung festgelegt ist. Eine in der SETENV-Anweisung festgelegte Variable überschreibt alle vorhandenen Variablen, die auf Betriebssystemebene festgelegt wurden. Verwenden Sie eine SETENV-Anweisung pro festzulegender Variable.

Für integrierte Extrakte können Sie neue Umgebungsvariablen festlegen, wenn diese über den lcr-Server verfügbar sind. Die neuen Umgebungsvariablen sind:

• USERNAME: Benutzername für Datenbankanmeldung

• OSUSERNAME: Benutzername des Betriebssystems

• MACHINENAME: Name des Hosts, Rechners oder Servers, auf dem die Datenbank ausgeführt wird

• PROGRAMNAME: Name des Programms oder der Anwendung, das bzw. die die Transaktion oder Session gestartet hat

• CLIENTIDENTIFIER: WerteSet mit DBMS_SESSION.set_identifier()

SETENV kann nicht mit Abfrageparametern verwendet werden.

Standard

Keine

Syntax

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

<environment_variable>

Der Name der festzulegenden Umgebungsvariablen.

TZ

(nur MySQL) Wenn Sie Oracle GoldenGate für MySQL auf einem Windows-Server oder auf einem Linux-Server (für OGG-Version unter 23.10.x) ausführen, der sich auf einem Remotehost vom Datenbankserver befindet, verwenden Sie den Parameter SETENV in der Extract-Parameterdatei, um die Zeitzone so festzulegen, dass sie mit der Zeitzone auf dem Datenbankserver übereinstimmt. Das folgende Format wird für Zeitzonenwerte für die Option TZ unterstützt:

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

Der Offset ist positiv, wenn die lokale Zeitzone westlich des Prime Meridian liegt und negativ, wenn sie östlich ist. Die Stunde muss zwischen 0 und 24 liegen, die Minute und die Sekunden zwischen 0 und 59.

<'value'>

Ein Wert für die angegebene Variable. Setzen Sie den Wert in einfache Anführungszeichen.

Beispiele

Beispiel 1

Mit separaten SETENV-Anweisungen kann eine einzelne Instanz von Oracle GoldenGate eine Verbindung zu mehreren Oracle AI Database-Instanzen herstellen, ohne die Umgebungseinstellungen ändern zu müssen. Die folgenden Parameteranweisungen legen einen Wert für ORACLE_HOME und ORACLE_SID fest.

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

Beispiel 2

Mit der folgenden Parameteranweisung wird die Zeitzone eines Oracle GoldenGate für MySQL Extract to Pacific Standard Time, UTC oder IST mit automatischem Sommerzeitwechsel festgelegt.

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