OGG 抽取进程ALTER EXTRACT用法

使用ALTER EXTRACT可以实现以下目的:

  • 配合ADD EXTRACT命令以创建 Extract 组的同时更改抽取进程的属性。
  • 将跟踪增加到序列中的下一个文件。
  • 升级到集成捕获模式配置。
  • 从集成捕获模式配置降级。
  • 将任何给定的 IBM for i 日志定位到特定的日志序列号处。
  • 将任何给定的 Informix 逻辑日志定位到特定的 LSN。

在使用此命令之前,使用STOP EXTRACT group_name命令停止Extract抽取进程 

语法:

ALTER EXTRACT group_name 
[, ADD_EXTRACT_ attribute ]
[, TRANLOG LRI_ number ]
[, UPGRADE INTEGRATED TRANLOG]
[, DOWNGRADE INTEGRATED TRANLOG [THREADS number ]]
[, THREAD number ]
[, LSN value ]
[, SCN value ]
[, ETROLLOVER]

ALTER EXTRACT DB2 for i 支持以下选项以定位到指定日志位置:

ALTER EXTRACT {BEGIN {NOW | YYYY-MM-DD [HH:MI:[SS [.cccccc]]] } 
[作者journal_library / JOURNAL_NAME [JRNRCV receiver_library /
RECEIVER_NAME ]] |
,EOF [作者journal_library / JOURNAL_NAME
[JRNRCV receiver_library / RECEIVER_NAME ]] |
,SEQNO sequence_number [作者journal_library / JOURNAL_NAME
[JRNRCV receiver_library / RECEIVER_NAME ]]}

group_name

要更改的 Extract 组的名称。

ADD_EXTRACT_attribute

您可以使用ADD EXTRACT命令更改指定抽取进程的任何属性,但以下属性除外:

  • 使用EXTTRAILSOURCE 选项更改抽取进程​ 
  • 使用THREADS选项更改抽取进程相关的 RAC 线程数。

对于这些场景,请删除 Extract 组,然后重新添加。

如果使用该BEGIN选项,请不要在语句中联合使用其他选项。发出单独的命令语句,例如:

ALTER EXTRACT finance,BEGIN 2011-01-01 
ALTER EXTRACT finance,ETROLLOVER
ALTER EXTRACT finance,SCN 789000

如果对 Integrated Extract使用SCN或者 BEGIN选项,则需要DBLOGIN登陆,并且指定的 SCN 或时间戳值不能低于服务器的第一个 SCN 或时间戳边界。要查找出服务器的第一个 SCN边界,请执行以下命令:

INFO EXTRACT group_name , SHOWCH DETAIL

列出的第一个 SCN 值如下例所示:

Integrated Extract outbound server first scn: 0.665884 (665884)

TRANLOG LRI_number

(DB2 LUW系统) 您可以使用LRI_number选项来指定DB2 LUW 系统系统检查点事务日志的 LRI 记录值。

UPGRADE INTEGRATED TRANLOG

将 Extract 组从经典捕获升级到集成捕获。为了支持升级,源或最小downstream系统上必须包含最早打开交易日志的起始记录。有关从经典捕获模式过渡到集成捕获模式的说明,请参阅​​管理适用于 Windows 和 UNIX 的 Oracle GoldenGate 中​​的完整过程。

DOWNGRADE INTEGRATED TRANLOG [THREADS number]

将 Extract 组从集成捕获降级为经典捕获。在 RAC 系统上降级时,必须使用THREADS选项来指定 RAC 线程的数量。在非 RAC 系统上,您可以选择指定THREADS 1​使降级的经典模式Extract抽取进程以一个线程模式运行,这类似于在非 RAC 系统上指定THREADS 1方式执行ADD EXTRACT。

请参阅​​管理适用于 Windows 和 UNIX 的 Oracle GoldenGate,了解​​从集成捕获模式转换到经典捕获模式的完整过程。

为了支持降级,源或最小downstream系统上必须有包含最早打开交易日志的起始记录。有关集成捕获的信息,请参阅​​为 Oracle 数据库安装和配置 Oracle GoldenGate​​。

THREAD number:对经典捕捉模式有效。在 Oracle RAC 配置中,alters Extract用于特定的redo thread。只能指定一个线程号。

LSN value:对 Informix 有效。从指定 EOF的特定LSN位置重新定位抽取进程。此选项是有效的经典捕获模式。

SCN value:对 Oracle 有效。重新定位抽取进程到重做日志中指定 Oracle 系统更改号 (SCN) 的事务。此选项对集成捕获模式和经典捕获模式均有效。

ETROLLOVER:重新启动时,使 Extract 递增到跟踪文件中的下一个序列。例如,如果当前文件是ET000002,则Extract 重新启动时当前文件将改变为ET000003。队列文件可以从 000001 递增到 999999,然后序列号从 000000 重新开始。

CPU number:对 SQL/MX 有效。用于指定进程的 CPU 编号。有效值为数字1-15并且-1是默认值,该值比上次启动的 Manager进程高 1。

PRI number:对 SQL/MX 有效。指定提取进程优先级。有效值为数字是1-199并且-1是默认值,并且与管理器进程优先级相同。

HOMETERM device_name:对 SQL/MX 有效。指定要使用的设备的名称,必须是终端或进程。它可以以 Guardian $或 OSS/G/xxxxx形式输入。默认为$zhome或当$zhome未定义时为当前会话的HOMETERM。

PROCESSNAME process_name:对 SQL/MX 有效。将进程的名称指定为最多五个字符的字母数字字符串,并且可以以 Guardian $或 OSS/G/xxxxx形式输入。默认是系统生成的进程名称。

BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}[JOURNAL journal_library/journal_name[JRNRCV receiver_library/ receiver_name]] |, EOF [JOURNAL journal_library/journal_name[JRNRCV receiver_library/receiver_name]] |, SEQNO sequence_number [JOURNAL journal_library/journal_name[JRNRCV receiver_library/receiver_name]]

IBM for i 选项,在全局起点发出后,允许journal-specific Extract 进程以ADD EXTRACT方式定位​。ALTER EXTRACT方式指定日志位置​不会影响先前设置的任何ADD EXTRACT或ALTER EXTRACT全局位置; 但是,ALTER EXTRACT方式的全局位置设置会覆盖之前在同一抽取进程中设置的任何特定日志位置。

注意:SEQNO与 ALTER EXTRACT操作一起使用时,SEQNO是特定事务相关的日志序列号,而不是跨事务日志的全局系统序列号。

例子

示例 1 :  

以下命令将 Extract抽取进程 更改为从 2011 年 1 月 1 日开始抽取数据。

ALTER EXTRACT finance,BEGIN 2011-01-01

示例 2 :  

以下命令将 Extract 抽取进程更改为从队列文件中的特定位置开始抽取数据。

ALTER EXTRACT finance,EXTSEQNO 26,EXTRBA 338

示例 3 :

以下将 Oracle RAC 环境中的 Extract抽取进程,并且新起始位置应用4个重做线程。

ALTER EXTRACT accounts,THREAD 4,BEGIN 2011-01-01

示例 4:   

以下在SQL Server 环境中,更改 Extract 抽取进程的LSN位置。

ALTER EXTRACT sales,LSN 3454:875:445

示例 5 :  

以下命令将Extract 抽取进程切换到下一个队列日志的序列号。

ALTER EXTRACT finance,ETROLLOVER

示例 6:   

以下将Extract从经典捕获模式升级为集成捕获模式。

ALTER EXTRACT finance,UPGRADE INTEGRATED TRANLOG

示例 7:

以下将RAC 环境中集成模式Extract抽取进程降级为经典捕获。

ALTER EXTRACT finance, DOWNGRADE INTEGRATED TRANLOG THREADS 3

示例 8: 

以下命令改变Oracle环境中Extract抽取进程从源数据库SCN 778899处开始抽取数据。

ALTER EXTRACT finance, SCN 778899

示例 9 :  

下面命令显示IBM for i中的抽取进程日志的起点。

ALTER EXTRACT finance, SEQNO 1234  JOURNAL accts/acctsjrn

示例 10:   

以下命令显示IBM for i中的抽取进程的日志和接收器起点。

ALTER EXTRACT finance,SEQNO 1234 JOURNAL accts/acctsjrn JRNRCV accts/jrnrcv0005

示例 11:   

以下更改 SQL/MX NonStop 平台上的 Extract抽取进程属性值。

ALTER EXTRACT exttcp, CPU 1, PRI 150, HOMETERM /G/zhome, PROCESSNAME $ose01

示例 12 :  

以下示例更改 DB2 LUW 系统上的 Extract抽取进程起始位置。

ALTER EXTRACT extcust, TRANLOG LRI 8066.322711