SETENV

有効な対象

ExtractおよびReplicat。

SETENV値は、パラメータ・ファイルのUSERIDALIAS、FETCHUSERIDALIAS、TRANLOGOPTIONS MININGUSERおよびMININGUSERIDALIASエントリの前に設定する必要があります。

摘要

SETENVパラメータでは、環境変数の値を設定します。ExtractまたはReplicatは、起動時に、オペレーティング・システム環境で設定された値ではなく、指定された値を使用します。SETENV文で設定された変数は、オペレーティング・システム・レベルで設定されているすべての既存の変数よりも優先されます。設定する変数ごとに1つのSETENV文を使用します。

統合Extractでは、lcrサーバーで使用できる場合に新しい環境変数を設定できます。新しい環境変数を次に示します。

• USERNAME: データベースのログイン・ユーザー名

• OSUSERNAME: オペレーティング・システムのユーザー名

• MACHINENAME: データベースが稼働しているホスト、マシンまたはサーバーの名前

• PROGRAMNAME: トランザクションまたはセッションを開始したプログラムまたはアプリケーションの名前

• CLIENTIDENTIFIER: DBMS_SESSION.set_identifier()を使用して設定される値

SETENVは、問合せパラメータと一緒に使用できません。

デフォルト

なし

構文

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

<environment_variable>

設定する環境変数の名前。

TZ

(MySQLのみ) Windowsサーバーまたはデータベース・サーバーのリモート・ホスト上にあるLinuxサーバー(23.10.xより前のOGGバージョン)でMySQL用のOracle GoldenGateを実行する場合は、Extractパラメータ・ファイル内のSETENVパラメータを使用して、データベース・サーバーのタイムゾーンと一致するようにタイムゾーンを設定します。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).

ローカル・タイム・ゾーンがPrime Meridianの西の場合は正、東の場合は負のオフセットです。時間は0から24の間でなければならず、分(および秒)は、もしあれば0から59の間でなければなりません。

<'value'>

指定する変数の値。値は一重引用符で囲みます。

例

例1

独立したSETENV文を使用すると、環境設定を変更せずに、単一のOracle GoldenGateインスタンスを複数のOracle AI Databaseインスタンスに接続できます。次のパラメータ文では、ORACLE_HOMEおよびORACLE_SIDの値を設定します。

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

例2

次のパラメータ文は、Oracle GoldenGate for MySQL Extractのタイムゾーンを、自動DSTスイッチングを使用して太平洋標準時(UTCまたはIST)に設定します。

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