1、ADD EXTRACT

使用ADD EXTRACT创建提取物组。除非SOURCEISTABLE指定了任务或别名Extract，否则将 ADD EXTRACT创建一个使用检查点的联机组，以便在每次运行之间保持处理连续性。

对于DB2 for i，此命令为所有日志建立全局起点，这是必需的第一步。发出ADD EXTRACT命令后，然后可以通过将ALTER EXTRACT命令与适当的日志选项一起使用，来选择将任何给定的日志定位在特定的日志序列号上。

PostgreSQL Extract是基于事务日志的。您需要提供 TRANLOG作为配置摘录的源。

Oracle GoldenGate每个Oracle GoldenGate Manager实例最多支持5,000个并发的Extract和Replicat组。在受支持的级别上，可以使用GGSCI命令（例如INFO和 STATUS命令）来控制和查看所有组。Oracle GoldenGate建议将提取和复制组的合并数量保持在默认级别300或更低，以便有效地管理环境。

对于所有关键字和输入，包括为该DESC选项输入的任何文本，此命令的大小不能超过500个字节。

语法：
ADD EXTRACT group_name
{, SOURCEISTABLE |
, TRANLOG [bsds_name |
, INTEGRATED TRANLOG |
, EXTFILESOURCE file_name |
, EXTTRAILSOURCE trail_name |
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, START]
[, EXTSEQNO sequence_number
[, EXTRBA offset_number |
[, EOF
[, LSN value |
[, EXTRBA relative_byte_address |
[, LRI value |
[, PAGE data_page, ROW row_ID |
[, SEQNO sequence_number
[, SCN value]
[, THREADS n]
[, PASSIVE]
[, PARAMS file_name]
[, REPORT file_name]
[, DESC 'description']
[, SOCKSPROXY {host_name | IP_address}[:port] [PROXYCSALIAS credential_store_alias [PROXYCSDOMAIN credential_store_domain]]]
[, RMTNAME passive_Extract_name]

group_name
提取组的名称。提取组的名称最多可以包含八个字符。

SOURCEISTABLE
创建一个Extract任务，该任务使用Oracle GoldenGate直接加载方法或直接批量加载到SQL * Loader方法从数据库中抽取整个记录以进行初始加载。如果SOURCEISTABLE未指定，则 ADD EXTRACT创建一个在线更改同步过程，并且必须指定其他数据源选项之一。使用时 SOURCEISTABLE，请勿指定任何服务选项。必须在参数文件中指定任务参数。

TRANLOG [bsds_name]
将事务日志指定为数据源。仅用于经典捕获。

对所有数据库使用此选项。TRANLOG需要 BEGIN选项。

（z / OS上的DB2）可以使用bsds_namez / OS系统上的DB2选项来指定事务日志的Bootstrap数据集文件名，尽管它不是必需的，也未使用。您不需要更改现有TRANLOG参数。

（Oracle）从Oracle Standard或Enterprise Edition 11.2.0.3开始，此模式称为经典捕获模式。提取直接读取Oracle重做日志。请参阅INTEGRATED TRANLOG，以获取替代配置。

（PostgreSQL）使用GGSCI将Extract添加TRANLOG为源。

INTEGRATED TRANLOG
（Oracle）以集成捕获模式添加此摘录。在这种模式下，Extract与数据库日志挖掘服务器集成，后者将逻辑更改记录（LCR）直接传递给Extract。提取不读取重做日志。使用之前 INTEGRATED TRANLOG，请使用REGISTER EXTRACT 命令。

EXTFILESOURCE file_name
指定提取文件作为数据源。将此选项与辅助Extract组（数据泵）一起使用，该辅助Extract组充当主Extract组和目标系统之间的中介。

对于file_name，请指定文件的相对或完全限定的路径名​​，例如\extfile。

EXTTRAILSOURCE trail_name
指定路径作为数据源。将此选项与辅助Extract组（数据泵）一起使用，该辅助Extract组充当主Extract组和目标系统之间的中介。

对于trail_name，指定路径的相对或完全限定路径名称，例如\aa。

BEGIN {NOW | yyyy-mm-ddthh:mm.ssZ}
指定数据源中开始处理的时间戳。

NOW
对于除DB2 LUW之外的所有数据库，NOW指定ADD EXTRACT发出命令的时间。

对于DB2 LUW，NOW指定START EXTRACT生效时间 。它定位到与日期和时间大致匹配的第一条记录。这是因为唯一包含时间戳的日志记录是提交和中止事务记录，因此只能相对于那些时间戳计算起始位置。这是Oracle GoldenGate使用的API的限制。必须注意的是，通过时间戳进行定位是不准确的，也可能需要很长时间。建议尽可能使用LRI或EOF选项。

请勿将其NOW用于数据泵Extract，除非将ADD EXTRACT语句之前捕获的数据绕过。

yyyy-mm-ddthh:mm:ssZ
给定格式的日期和时间（时间戳）。例如，2017-07-14T14：54：45Z。

yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]
给定格式的日期和时间（时间戳）。对于处于集成模式的Oracle摘录，时间戳记值必须大于该摘录在数据库中注册的时间戳记。

START
对PostgreSQL有效。

添加未提及BEGIN NOW或 的摘录LSN。提取将自动从复制插槽重新启动位置开始。

EXTSEQNO sequence-number
适用于Oracle经典捕获模式下的主提取。集成模式下的Oracle Extract不支持。指定开始捕获数据的Oracle重做日志的序列号。使用此选项之前，请联系Oracle支持。

EXTRBA archive-offset_number
对DB2 z / OS和Oracle数据库有效。指定事务日志中要开始捕获数据的相对字节地址。

要求的格式为0Xnnn，其中nnn为1到20位的十六进制数字（第一个字符为数字零，第二个字符可以为大写或小写字母x）。

EOF
对SQL Server，DB2 for i，DB2 LUW，PostgreSQL有效。将处理配置为从下一条记录将写入的日志文件（或日志）的末尾开始。任何活动的交易都不会被捕获。

对于DB2 LUW，它将处理配置为从LRI日志文件中的活动值开始 。活动目录LRI是下一条记录将写入的日志文件末尾的位置。任何活动的交易都不会被捕获。

对于PostgreSQL，DBLOGIN位置必须为EOF。

LSN value
对SQL Server，DB2 z / OS和PostgreSQL有效。

指定LSN开始捕获数据的事务。此选项的别名是EXTLSN。指定的值LSN 应作为有效值tran_begin_lsn存在于 cdc.lsn_time_mapping系统表中，否则，提取将尝试定位在LSN提供的值之后。
对于PostgreSQL，LSN值可以是 hi或lo。设置与hi日志文件的入口点相同的值。Lo是日志文件中的偏移量。该LSN位置应位于复制插槽重新启动位置和预先写入日志当前位置之间。如果指定的位置本身在上述范围之间，则提取将引发错误。

（SQL Server）指定LSN开始捕获数据的事务。此选项的别名是EXTLSN。

指定的内容LSN应作为有效值tran_begin_lsn 存在于cdc.lsn_time_mapping系统表中，否则，提取将尝试定位在提供的LSN值之后。

有效 LSN规范包括以下内容：
冒号分隔的十六进制字符串（8：8：4）用前导零和0X前缀填充，如0X00000d7e：0000036b：0001
冒号分隔的十进制字符串（10：10：5）用前导零填充，如0000003454：0000000875：00001
冒号分隔的具有0X前缀且不带前导零的十六进制字符串，例如0Xd7e：36b：1
冒号分隔的十进制字符串，不带前导零，如3454：875：1
十进制字符串，如3454000000087500001

LRI value
对DB2 LUW有效。指定开始提取时事务日志中的开始位置。

您可以使用LRI用于DB2 LUW系统的选项来指定LRI摘录可以开始从事务日志中捕获记录的位置。您可以使用DB2实用程序db2logsForRfwd来获取LRI。该实用程序提供LRI了DB2日志中存在的范围。

需要注意的是，虽然提取威力位置给定 LRI，即LRI不一定是第一个将提取处理。提取中忽略的日志文件中有许多记录类型，例如DB2内部日志记录。提取将向LRI提取报告文件报告实际的开始。

SEQNO sequence_number
对DB2 for i有效。在系统序列号或系统序列号之后立即开始捕获，该系统序列号是一个十进制数字，长度最多20位。

SCN value
对Oracle有效。在具有指定的Oracle系统更改号（SCN）的重做日志中的事务处启动Extract。此选项对经典捕获和集成模式下的提取均有效。对于集成模式下的摘录，SCN值必须大于在数据库中注册摘录的SCN值。有关更多信息，请参见REGISTER EXTRACT。

PARAMS file_name
dirprm在Oracle GoldenGate目录的默认位置以外的其他位置，指定Extract参数文件的全路径名。

REPORT file_name
dirrpt在Oracle GoldenGate目录的默认位置以外的其他位置，指定Extract报告文件的全路径名。

THREADS n
对Oracle经典捕获模式有效。指定Extract维护以读取重做日志的生产者线程数。

在Oracle RAC配置中必需，以指定生产者线程数。这些是提取线程，可读取各个RAC节点上的不同重做日志。该值必须与要从其捕获重做数据的节点数相同。

PASSIVE
指定此提取组以被动模式运行，并且只能通过在目标系统上启动或停止别名提取组来启动和停止。源目标连接将不是由该组建立的，而是由别名“从目标提取”建立的。

此选项可用于常规提取组或数据泵提取组。无论源系统上的哪个Extract将通过网络将数据发送到目标上的远程路径的任何提取，都应使用它。

DESC 'description'
指定组的描述，例如'Extracts account_tab on Serv1'。将描述用单引号引起来。您可以使用缩写关键字DESC或完整单词 DESCRIPTION。

ENCRYPTIONPROFILE
指定与特定客户端关联的Oracle GoldenGate加密配置文件的名称。

CRITICAL
指示该过程对于部署是否至关重要。

PROFILE
自动启动配置文件的名称。

AUTOSTART
将提取的自动开始值设置为YES或NO。

RETRIES
在中止重试工作之前重新启动任务的最大尝试次数。这是可选的。

WAITSECONDS
重试的持续时间（以秒为单位）。

RESETSECONDS
重置重试计数的持续时间。

DISABLEONFAILURE
如果设置为TRUE，则当重试次数用完后，该任务将被禁用。

SOCKSPROXY{ host_name| IP_address} [：port] [ PROXYCSALIAS credential_store_alias[ PROXYCSDOMAIN credential_store_domain]
用于别名提取。指定代理服务器的DNS主机名或IP地址。您可以使用任何一种来定义主机，但是如果无法访问DNS服务器，则必须使用IP地址。如果使用的是IP地址，请使用IPv6或IPv4映射的地址，具体取决于目标系统的堆栈。您必须指定PROXYCSALIAS。此外，您可以指定要使用的端口以及凭据存储域。

RMTNAME passive_extract_name
用于别名提取。指定被动提取名称（如果与别名“提取”不同）。

举例1：

GGSCI (oracle11g) 2> ADD EXTRACT test1, TRANLOG, BEGIN NOW
EXTRACT added.

GGSCI (oracle11g) 3> info all

Program     Status      Group       Lag at Chkpt  Time Since Chkpt

MANAGER     STOPPED                                           
EXTRACT     STOPPED     TEST1       00:00:00      00:00:02

举例2：

GGSCI (oracle11g) 1> DBLOGIN USERID ogg PASSWORD ogg
Successfully logged into database.

GGSCI (oracle11g as ogg@orcl) 2> REGISTER EXTRACT test2 DATABASE

2020-11-30 16:38:44  INFO    OGG-02003  Extract TEST2 successfully registered with database at SCN 2386408.

GGSCI (oracle11g as ogg@orcl) 3> ADD EXTRACT test2, INTEGRATED TRANLOG, BEGIN NOW 
EXTRACT (Integrated) added.

举例3：

GGSCI (oracle11g as ogg@orcl) 5> ADD EXTRACT test4, SOURCEISTABLE
EXTRACT added.

举例4：

GGSCI (oracle11g as ogg@orcl) 6> ADD EXTRACT test5 TRANLOG, BEGIN NOW, PASSIVE
EXTRACT added.

2、ALTER EXTRACT

使用ALTER EXTRACT以下用途：
更改使用ADD EXTRACT命令创建的提取组的属性。
将线索增加到序列中的下一个文件。
升级到集成捕获配置。
从集成捕获配置降级。
将任何给定的DB2 for i日志定位在特定的日志序列号上。

使用此命令之前，请使用命令停止Extract STOP EXTRACT group_name。

语法：
ALTER EXTRACT group-name
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, START]
[, EXTSEQNO sequence-number]
[, EXTRBA offset-number]
[, TRANLOG LRI LRI_number]
[, UPGRADE INTEGRATED TRANLOG]
[, DOWNGRADE INTEGRATED TRANLOG [THREADS number]]
[, THREAD number]
[, LSN value]
[, SCN value]
[, ETROLLOVER]
[, INFO EXTRACT group-name]

group-name
要更改的提取组的名称。

{BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}
NOW
对于除DB2 LUW之外的所有数据库，NOW指定ALTER EXTRACT发出命令的时间。

对于DB2 LUW，NOW指定START EXTRACT生效时间 。它定位到与日期和时间大致匹配的第一条记录。这是因为唯一包含时间戳的日志记录是提交和中止事务记录，因此只能相对于那些时间戳计算起始位置。这是Oracle GoldenGate使用的API的限制。

请勿将其NOW用于数据泵Extract，除非将ADD EXTRACT语句之前捕获的数据绕过。

YYYY-MM-DDThh:mm:ssZ
给定格式的日期和时间（时间戳）。例如，2017-07-14T14：54：45Z。

yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]
给定格式的日期和时间（时间戳）。对于处于集成模式的Oracle摘录，时间戳记值必须大于该摘录在数据库中注册的时间戳记。

SQL Server事务日志中的时间戳在SQL Server事务日志中的位置受到以下SQL Server特性的影响：

SQL Server事务日志中记录的时间戳使用3.3333微秒（ms）的粒度。如果事务以相同的3.3333 ms时间间隔开始，则此粒度级别可能不允许按时间在两个事务之间进行定位。

时间戳记不会记录在每个SQL Server日志记录中，而只会记录在开始和提交事务的记录中，以及一些不包含数据的记录中。

SQL Server时间戳不是来自系统时钟，而是来自特定于所使用的单个处理器的内部时钟。此时钟每秒更新几次，但在两次更新之间可能会与系统时钟不同步。这进一步降低了时间定位的精度。

为日志备份文件记录的时间戳记可能与备份内部记录的时间不完全对应（但是这种不精确度小于一秒）。

定位到LSN是精确的。

START
对PostgreSQL有效。

添加未提及BEGIN NOW或 的摘录LSN。提取将自动从复制插槽重新启动位置开始。

ADD_EXTRACT_attribute
您可以更改ADD EXTRACT命令指定的任何属性，以下各项除外：

更改使用该EXTTRAILSOURCE选项指定的摘录 。

更改使用该THREADS选项指定的RAC线程数 。

对于这些例外，请删除“提取”组，然后再次添加它。

如果使用该BEGIN选项，请不要在语句中组合其他选项。

如果对集成提取使用SCN或BEGIN选项，则它需要一个DBLOGIN，并且指定的SCN或时间戳记值不能低于出站服务器的第一个SCN或时间戳记。

EXTSEQNO sequence_number
适用于Oracle经典捕获模式下的主数据提取和数据泵数据提取。集成模式下的Oracle Extract不支持。指定以下任意一项：

Oracle重做日志和该日志中的RBA的序列号，从该序列号开始捕获数据。

该文件中开始捕获数据的相对字节地址。这些共同指定了TMF主审核跟踪（MAT）中的位置。

该文件位于开始捕获数据的路径中（对于数据泵）。指定序列号，但不指定用于填充的任何零。例如，如果跟踪文件为\aa000026，则可以指定 EXTSEQNO 26。默认情况下，除非使用此选项，否则处理将从跟踪的开头开始。

使用此选项之前，请联系Oracle支持。有关更多信息，请访问http://support.oracle.com.

EXTRBA offset_number
对Oracle数据库有效。指定事务日志中要开始捕获数据的相对字节地址。

要求的格式为0Xnnn，其中nnn为1到20位的十六进制数字（第一个字符为数字零，第二个字符可以为大写或小写字母x）。

EOF
（PostgreSQL）您可以为PostgreSQL使用此选项来指定 EOF值。DBLOGIN是必须的。

TRANLOG LRI LRI_number
（DB2 LUW）可以将此选项用于DB2 LUW系统，以为检查点事务日志指定LRI记录值。

对于PostgreSQL，DBLOGIN 位置必须为EOF。

UPGRADE INTEGRATED TRANLOG
将“提取”组从经典捕获升级为集成捕获。为了支持升级，包含最早的未完成交易的开始的交易日志必须在源或下游采矿系统上可用。

DOWNGRADE INTEGRATED TRANLOG [THREADS number]
将“提取”组从集成捕获降级为经典捕获。在RAC系统上降级时，THREADS必须使用该选项来指定RAC线程数。在非RAC系统上，您可以选择指定 THREADS 1使降级的经典Extract在一个线程下以线程模式运行，这ADD EXTRACT与THREADS 1在非RAC系统上执行with相似。

为了支持降级，包含最早的未清事务的开始的事务日志必须在源或下游采矿系统上可用。

THREAD number
适用于经典捕获模式。在Oracle RAC配置中，仅更改指定重做线程的提取。只能指定一个线程号。

SCN value
对Oracle有效。在具有指定的Oracle系统更改号（SCN）的重做日志中的事务处启动Extract。此选项对经典捕获和集成模式下的提取均有效。对于集成模式下的摘录，SCN值必须大于在数据库中注册摘录的SCN值。如果将SCN或BEGIN选项用于Integrated Extract，则它需要一个DBLOGIN，并且指定的SCN或时间戳记值不能低于出站服务器的第一个SCN或时间戳记。

LSN value
对SQL Server，DB2 z / OS和PostgreSQL有效。指定LSN开始捕获数据的事务。此选项的别名是EXTLSN。指定的值 LSN应作为有效值tran_begin_lsn存在于cdc.lsn_time_mapping系统表中，否则，提取将尝试定位在LSN提供的值之后。
对于PostgreSQL，LSN值可以是 hi或lo。设置与hi日志文件的入口点相同的值。Lo是日志文件中的偏移量。该LSN位置应位于复制插槽重新启动位置和预先写入日志当前位置之间。如果指定的位置本身在上述范围之间，则提取将引发错误。

（SQL Server）指定LSN开始捕获数据的事务。此选项的别名是EXTLSN。

指定的内容LSN应作为有效值tran_begin_lsn 存在于cdc.lsn_time_mapping系统表中，否则，提取将尝试定位在提供的LSN值之后。

有效的LSN规范包括以下内容：
冒号分隔的十六进制字符串（8：8：4）用前导零和0X前缀填充 ，如 0X00000d7e:0000036b:0001

冒号分隔的十进制字符串（10：10：5）用前导零填充，如 0000003454:0000000875:00001

冒号分隔的带0X前缀且不带前导零的十六进制字符串，如0Xd7e:36b:1

冒号分隔的十进制字符串，不带前导零，如 3454:875:1

十进制字符串，如 3454000000087500001

ETROLLOVER
用于需要重新定位和重新生成主提取文件的跟踪文件的手动恢复情况，以及从先前版本升级Oracle GoldenGate时的情况。

使Extract创建跟踪文件的新版本，并在重新启动时递增到跟踪序列中的下一个文件，这需要将读取器（例如pump或Replicat）手动重新定位到新的跟踪序列号。

从19c开始，在分发服务器处理期间：
如果源主摘录已用目标跟踪文件升级 ETROLLOVER，则分发服务器将自动检测源跟踪文件ETROLLOVER并开始从下一个输入跟踪文件读取。这与数据泵相同 。 ALTER EXTRACT groupname EXTSEQNO seqno+1 EXTRBA 0

升级分发服务器后，重新启动后，它将自动对输出跟踪文件执行ETROLLOVER，并正确写入下一个跟踪文件。这与数据泵相同。 ALTER EXTRACT groupname ETROLLOVER

DESC 'description'
指定组的描述，例如'Extracts account_tab on Serv1'。将描述用单引号引起来。您可以使用缩写关键字DESC或完整单词 DESCRIPTION。

ENCRYPTIONPROFILE
指定摘录的加密配置文件的名称。该名称区分大小写，因此您必须使用输入的确切名称ADD EXTRACT。
CRITICAL
指示该过程对于部署是否至关重要。

PROFILE
自动启动配置文件的名称。该名称区分大小写，因此您必须使用输入的确切名称ADD EXTRACT。
AUTOSTART
将提取的自动开始值设置为YES或NO。
RETRIES
在中止重试工作之前重新启动任务的最大尝试次数。这是可选的。

WAITSECONDS
重试的持续时间（以秒为单位）。

RESETSECONDS
重置重试计数的持续时间。
DISABLEONFAILURE
如果设置为TRUE，则当重试次数用完后，该任务将被禁用。

3、CLEANUP EXTRACT

使用CLEANUP EXTRACT删除运行历史记录指定的提取物组。清除操作将使上次运行记录保持不变，以便Extract可以从上次停止的地方继续处理。使用此命令之前，请通过发出STOP EXTRACT命令停止Extract 。

语法：
CLEANUP EXTRACT group_name [, SAVE count]

group_name
提取组的名称或用于指定多个组的通配符（）。例如， T清除名称以T开头的所有提取组。

SAVE count
从清除中排除指定数量的最新记录。

举例：

GGSCI (oracle11g as ogg@orcl) 10> cleanup EXTRACT EXTKAFKA
Cleanup completed

4、DELETE EXTRACT

使用DELETE EXTRACT删除的提取物组。此命令删除属于该组的检查点文件，但参数文件保持不变。然后，您可以根据需要重新创建组或删除参数文件。

在使用之前，使用命令DELETE EXTRACT停止Extract STOP EXTRACT。

语法：
DELETE EXTRACT group_name [!]

group_name
提取组的名称或用于指定多个组的通配符规范（）。例如， T删除名称以T开头的所有提取组。

!
（感叹号）在不提示的情况下删除与通配符关联的所有提取组。

举例：

GGSCI (oracle11g as ogg@orcl) 16> delete EXTRACT TEST5 !
Deleted EXTRACT TEST5.

5、INFO EXTRACT

使用INFO EXTRACT查看以下信息。

提取的状态（STARTING，RUNNING， STOPPED或ABENDED）。STARTING表示该过程已经开始，但尚未锁定检查点文件进行处理。

大约提取延迟。

检查点信息。

流程运行历史。

Extract正在写入的路径。

集成摘录的升级或降级状态

提取可以在INFO EXTRACT发出时运行或停止。对于正在运行的进程，状态RUNNING可以表示以下之一：

活动：运行和处理（或能够处理）数据。这是进程启动后的正常状态。

已暂停：进程正在运行，但由于某个EVENTACTIONS SUSPEND操作而已暂停 。在挂起状态下，该过程未处于活动状态，无法处理任何数据，但是当前运行的状态得以保留，并且可以通过发出SEND EXTRACT带有该RESUME选项的命令 来继续执行。INFO命令中的RBA反映了挂起操作之前的最后一个检查点位置。要确定状态是活动还是暂停，请发出SEND EXTRACT带有STATUS选项的命令 。

基本命令仅显示在线（连续）提取过程的信息。任务被排除在外。

语法：
INFO EXTRACT group_name
[, SHOWCH [checkpoint_number]]
[, DETAIL]
[, TASKS | ALLPROCESSES]
[, UPGRADE | DOWNGRADE]
[, CONTAINERS]

group_name
提取组的名称或用于指定多个组的通配符（）。例如，T显示有关名称以T开头的所有Extract组的信息。您可以列出以指定的Extract组名注册的PDB。

SHOWCH [checkpoint_number]
基本命令显示有关当前提取检查点的信息。提取检查点位置由数据源中的读取检查点和路径中的写入检查点组成。路径类型RMTTRAIL或 EXTTRAIL也被注明。

（可选）指定一个值， checkpoint_number以包括指定数量的先前检查点以及当前检查点。

DETAIL
显示以下内容：

提取运行历史记录，包括数据源中的起点和终点，以时间表示。

提取物正在写入的路径。

TASKS
仅显示提取任务。由通配符参数指定的任务不会显示INFO EXTRACT。

ALLPROCESSES
显示所有提取组，包括任务。

UPGRADE | DOWNGRADE
仅对Oracle数据库有效。
UPGRADE 显示摘录是否可以从经典捕获模式升级到集成捕获模式。
DOWNGRADE 显示摘录是否可以从集成捕获模式降级为经典捕获模式。

如果摘录无法升级或降级，则会显示原因。

此选项不允许使用通配的摘录名称。

使用此命令之前，请发出DBLOGIN 命令。

CONTAINERS
列出在指定的提取组中注册的PDB。但是，如果命令在非CDB模式下运行或Extract组不存在，则该命令将出错。DBLOGIN使用此选项之前，请发出命令。

举例1：

GGSCI (oracle11g as ogg@orcl) 20> info extract extkafka ,SHOWCH

EXTRACT    EXTKAFKA  Last Started xxxx-xx-02 10:24   Status STOPPED
Checkpoint Lag       00:00:00 (updated 2141:59:30 ago)
Log Read Checkpoint  Oracle Redo Logs
                     xxxx-xx-02 11:06:14  Seqno 131, RBA 6727168
                     SCN 0.2324099 (2324099)

Current Checkpoint Detail:

Read Checkpoint #1

  Oracle Redo Log

  Startup Checkpoint (starting position in the data source):
    Thread #: 1
    Sequence #: 131
    RBA: 2956288
    Timestamp: xxxx-xx-02 10:22:21.000000
    SCN: Not available
    Redo File: 

  Recovery Checkpoint (position of oldest unprocessed transaction in the data source):
    Thread #: 1
    Sequence #: 131
    RBA: 6726160
    Timestamp: xxxx-xx-02 11:06:12.000000
    SCN: 0.2324097 (2324097)
    Redo File: /u01/app/oracle/oradata/orcl/redo06.log

  Current Checkpoint (position of last record read in the data source):
    Thread #: 1
    Sequence #: 131
    RBA: 6727168
    Timestamp: xxxx-xx-02 11:06:14.000000
    SCN: 0.2324099 (2324099)
    Redo File: /u01/app/oracle/oradata/orcl/redo06.log

Write Checkpoint #1

  GGS Log Trail

  Current Checkpoint (current write position):
    Sequence #: 0
    RBA: 1382
    Timestamp: xxxx-xx-02 11:06:16.994369
    Extract Trail: ./dirdat/gs
    Seqno Length: 9
    Flip Seqno Length: No
    Trail Type: EXTTRAIL

Header:
  Version = 2
  Record Source = A
  Type = 10
  # Input Checkpoints = 1
  # Output Checkpoints = 1

File Information:
  Block Size = 2048
  Max Blocks = 100
  Record Length = 2048
  Current Offset = 0

Configuration:
  Data Source = 3
  Transaction Integrity = 1
  Task Type = 0

Status:
  Start Time = xxxx-xx-02 10:24:41
  Last Update Time = xxxx-xx-02 11:06:16
  Stop Status = G
  Last Result = 400

举例2：

GGSCI (oracle11g as ogg@orcl) 25> INFO EXTRACT extkafka UPGRADE
ERROR: Extract EXTKAFKA is not ready to be upgraded because recovery SCN 2324097 has not reached SCN 2405774.

GGSCI (oracle11g as ogg@orcl) 26> INFO EXTRACT extkafka DOWNGRADE 
ERROR: EXTRACT EXTKAFKA is not configured for integrated capture.

举例3：

GGSCI (oracle11g as ogg@orcl) 19> info extract extkafka ,detail

EXTRACT    EXTKAFKA  Last Started xxxx-xx-02 10:24   Status STOPPED
Checkpoint Lag       00:00:00 (updated 2141:56:17 ago)
Log Read Checkpoint  Oracle Redo Logs
                     xxxx-xx-02 11:06:14  Seqno 131, RBA 6727168
                     SCN 0.2324099 (2324099)

  Target Extract Trails:

  Trail Name                                       Seqno        RBA     Max MB Trail Type

  ./dirdat/gs                                          0       1382       1024 EXTTRAIL  

  Extract Source                          Begin             End             

  /u01/app/oracle/oradata/orcl/redo06.log  xxxx-xx-02 10:22  xxxx-xx-02 11:06

Current directory    /ogg/ogg

Report file          /ogg/ogg/dirrpt/EXTKAFKA.rpt
Parameter file       /ogg/ogg/dirprm/extkafka.prm
Checkpoint file      /ogg/ogg/dirchk/EXTKAFKA.cpe
Process file         /ogg/ogg/dirpcs/EXTKAFKA.pce
Error log            /ogg/ogg/ggserr.log