SETENV

有效对象

提取和复制。

应在参数文件中的任何 USERIDALIAS、FETCHUSERIDALIAS、TRANLOGOPTIONS MININGUSER 和 MININGUSERIDALIAS 项之前设置任何 SETENV 值。

说明

使用 SETENV 参数设置环境变量的值。提取或复制启动时，它将使用指定的值，而不是在操作系统环境中设置的值。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 时，如果该版本位于来自数据库服务器的远程主机上，请使用提取参数文件中的 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 AI Database 实例，而无需更改环境设置。以下参数语句为 ORACLE_HOME 和 ORACLE_SID 设置值。

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

示例 2

以下参数语句使用自动 DST 切换将 Oracle GoldenGate for MySQL Extract 的时区设置为 Pacific Standard Time、UTC 或 IST。

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