SETENV

適用対象

ExtractおよびReplicat。

SETENVの値は、パラメータ・ファイルのエントリUSERIDALIASFETCHUSERIDALIASTRANLOGOPTIONS MININGUSERMININGUSERIDALIASの前に設定する必要があります。

説明

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サーバー(21.20.xより前のOGGバージョンの場合)でOracle GoldenGate for MySQLを実行する場合は、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).

ローカル・タイム・ゾーンが本初子午線の西にある場合、オフセットは正で、東の場合は負です。時は0から24の間、および分と秒は0から59の間である必要があります。

'value'

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

例1

独立したSETENV文を使用すると、環境設定を変更せずに、単一のOracle GoldenGateインスタンスを複数のOracleデータベース・インスタンスに接続させることができます。次のパラメータ文では、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')