塞滕夫

有效對象

擷取與 Replicat。

任何 SETENV 值都必須在參數檔中的任何 USERIDALIAS、FETCHUSERIDALIAS、TRANLOGOPTIONS MININGUSER、MININGUSERIDALIAS 項目之前設定。

說明

使用 SETENV 參數來設定環境變數的值。Extract 或 Replicat 啟動時，會使用指定的值，而非作業系統環境中設定的值。SETENV 敘述句中的變數集會覆寫在作業系統層次設定的所有現有變數。每個要設定的變數使用一個 SETENV 敘述句。

對於整合式擷取，您可以設定新的環境變數 (如果可從 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 版本) 上執行 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).

如果當地時區為 Prime Meridian 的西部，則偏移為正數；如果為 East，則為負數。小時必須介於 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 的時區設為太平洋標準時間、UTC 或 IST，而且會自動切換 DST。

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