OGG 19C—— 三、Oracle GoldenGate 基本命令
1、OGG命令
windows右击以管理员执行%OGG_HOME%\GGSIC.cmd/ linux执行./GGSIC.sh
1.1、
！：执行最新的一个命令。
1.2、创建一个chekpoint
登录pdb用户dblogin userid hr ,password hr
>add checkpointtable pdborcl.hr.chkpttable
>info checkpointtable pdborcl.hr.chkpttable.
>dblogin userid c##oggadmin ,password oggadmin
edit params GLOBALS
GGSCHEMA c##oggadmin
checkpointtable pdborcl.hr.chkpttable--在pdb的用户hr创建
1.3创建一个认证
GGSCI (ogg1) 2> add credentialstore
Credential store created.
GGSCI (ogg1) 3> alter credentialstore add user c##[email protected],password oggadmin alias oggadmin
Credential store altered.
GGSCI (ogg1) >info credentialstore
default:OracleGoldenGate
GGSCI (ogg1) 5> dblogin useridalias oggadmin
1.4、创建一个EXTRACT。（ 此处是GGSCI Syntax。不是Admin Client Syntax）
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]
1.5、添加附加 EXTTRAIL（与extract group关联，并分配最大文件大小）
ADD EXTTRAIL trail_name, EXTRACT group_name
[, FORMAT RELEASE major.minor]
[, MEGABYTES n] --跟踪中文件的最大大小（以兆字节为单位）。默认值为500
[SEQNO n] --SEQNO 3。实际文件将命名为/tr000000003 预设为1
eg： add exttrail C:\ogg_src\dirdat\ex , extract ext1
路径的名称只能是2个字符不然报错。
1.6、添加心跳机制 ADD HEARTBEATTABLE
ADD HEARTBEATTABLE
[, FREQUENCY number_in_seconds]
[, RETENTION_TIME number_in_days] |
[, PURGE_FREQUENCY number_in_days]
[, PARTITIONED]
[, TARGETONLY]
1.7、ADD MASTERKEY （ 提取和复制使用主**对加***进行加密，以保护通过网络和跟踪文件发送的数据，以便可以将这些**发送给下游进程，并供下游进程使用）
>add masterkey
1.8 ADD PROCEDURETRANDATA (添加补充日志的程序复制)
1.9、ADD REPLICAT
ADD REPLICAT group_name
[, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
{, SPECIALRUN |
, EXTFILE file_name |
, EXTTRAIL trail_name}
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, EXTSEQNO sequence_number, EXTRBA rba]
{, CHECKPOINTTABLE owner.table | NODBCHECKPOINT}
[, PARAMS file_name]
[, REPORT file_name]
eg:add replicat rep1 integrated exttrail c:\ogg_tar\dirdat\ex checkpointtable pdborcl.hr.chkpttable
如果没有integrated则以非集成经典模式复制。
parallel只对oracle有效。
COORDINATED协调复制需要检查点。
MAXTHREADS number 最大线程组 默认25，最大500
2.0、ADD RMTTRAIL 分配最大文件大小，将目标路径和源的EXTRACT相关
ADD RMTTRAIL trail_name, EXTRACT group_name
[, FORMAT RELEASE major.minor]
[, MEGABYTES n]
[, SEQNO n]
ADD RMTTRAIL c:\ogg_tar\dirdat\ex, EXTRACT finance, MEGABYTES 200
2.1、ADD SCHEMATRANDATA对经典和集成都有效
ADD SCHEMATRANDATA schema {
[ALLOWNONVALIDATEDKEYS]
[NOSCHEDULINGCOLS | ALLCOLS]}
[NOVALIDATE]
[PREPARECSN {WAIT | LOCK | NOWAIT | NONE}]
其中schema不要使用通配符，pdb用户先用dblogin登录再分别添加。
添加附加日志： add schematrandata pdborcl.hr
记录没有主键的所有表和未来的表： add schematrandata pdborcl.hr allcols
2.2、ADD TRACTTABLE 添加跟踪 ，跟踪表必须在extract用户模式中，该用户表使用userid参数进行配置，跟踪表可防止在双向同步配置中再次提取复制事务。
ADD TRACETABLE [[container.]owner.table]
ADD TRACETABLE ora_trace
2.3、ADD TRANDATA 能获取所有转换记录但是先用dblogin登录，
尽可能使用ADD SCHEMATRANDATA 而不是ADD TRANDATA。可以使用ADD SCHEMATRANDATA 和ADD TRANDATA记录所有非主键的列。比如filter和keycols的列。
ADD TRANDATA {[container.]owner.table | schema.table [JOURNAL
library/journal] |
library/file [JOURNAL library/journal]}
[, FILEGROUP filegroup-name]
[, NOSCHEDULINGCOLS | ALLCOLS]
[, COLS (columns)]
[, INCLUDELONG | EXCLUDELONG]
[, NOKEY]
[, KEYCOLSONLY]
[, NOVALIDATE]
[, PREPARECSN {WAIT | LOCK | NOWAIT | NONE}]
2.4、 ALLOWNESTED | NOALLOWNESTED
启用或者禁用 嵌套文件OBEY。就是调用脚本，脚本里面含有对应的命令行。
OBEY ./addcmds.txt
2.5、alter credentialstore 修改身份凭证、
ALTER CREDENTIALSTORE {
ADD USER userid[@tns_alias] |
REPLACE USER userid |
DELETE USER userid }
[PASSWORD password]
[ALIAS alias]
[DOMAIN domain]
创建一个凭证：ALTER CREDENTIALSTORE ADD USER scott PASSWORD tiger ALIAS scsm2
删除一个凭证：ALTER CREDENTIALSTORE DELETE USER user1
2.6、ALTER EXTRACT 修改一个抽取
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]
修改一个抽取开始时间：ALTER EXTRACT finance, BEGIN 2011-01-01
修改抽取从经典模式到集成模式：ALTER EXTRACT finance, UPGRADE INTEGRATED TRANLOG
修改oracle开始scn号：ALTER EXTRACT finance, SCN 778899
2.7、ALTER EXTTRAIL 修改创建跟踪属性。
ALTER EXTTRAIL Trail_name，EXTRACT group_name
[，MEGABYTES n ]
2.8、 ALTER HEARTBEATTABLE 修改心跳
ALTER HEARTBEATTABLE
[, FREQUENCY number_in_seconds]
[, RETENTION_TIME number_in_days] |
[, PURGE_FREQUENCY number_in_days]
[, TARGETONLY | NOTARGETONLY]
2.9、ALTER REPLICAT 修改复制抽取，在使用此命令前先停止该复制。
ALTER REPLICAT
group-name|
[INTEGRATED | [ NONINTEGRATED [ CHECKPOINTTABLE <table-name> ] ]
]|
[SPECIALRUN ||
EXTFILE file-name ||
EXTTRAIL trail-name ]| [
BEGIN ( NOW | begin-datetime ) ||
EXTSEQNO trail-sequence-number [ EXTRBA trail-offset-number ]
]|
[DESC description ]|
[ENCRYPTIONPROFILE encryption-profile-name ]|
[
CRITICAL [ YES | NO ] ]|
[PROFILE profile-name|
[AUTOSTART [ YES | NO ]|
[DELAY delay-number ] ]|
[
AUTORESTART [ YES | NO ]|
[
RETRIES <retries-number> ]|
[
WAITSECONDS <wait-number> ]|
[
RESETSECONDS <reset-number> ]| [
DISABLEONFAILURE [ YES | NO ] ] ] ]
}
3.0、ALTER RMTTRAIL 修改远程上面的跟踪
ALTER RMTTRAIL Trail_name，EXTRACT group_name
[，MEGABYTES n ]
3.1、CLEANUP CHECKPOINTTABLE 清理检查点。
首先登录pdb用户，
CLEANUP CHECKPOINTTABLE [[container. | catalog.]owner.table]
3.2、CLEANUP EXTRACT 清除抽取，可以保留最后几条记录，以便可以恢复，在使用该命令前使用stop extract。
CLEANUP EXTRACT group_name [, SAVE count]
CLEANUP EXTRACT EXT1, SAVE 5
3.3、CLEANUP REPLICAT 清除复制 可以清除复制运行历史记录，会保留最后几条记录，以便可以从他停止的地方继续。在使用此命令前，使用stop replicat来停止。
CLEANUP REPLICAT group_name[threadID] [, SAVE count]
CLEANUP REPLICAT fin003, SAVE 5
3.4、DELETE CHECKPOINTTABLE 删除检查点
STOP REPLICAT group >DELETE REPLICAT group >ADD REPLICAT group, EXTTRAIL trail, NODBCHECKPOINT
Exit GGSCI or Admin Client, then start it again. >START REPLICAT group
...
...
...
命令太多，建议查阅对应OGG版本资料 ,
下面记录一些常用的
4.7、EDIT PARAMS 编辑参数
EDIT PARAMS {MGR | group_name | file_name}
MGR:指的是MANAGER程序。
group name: 指的是extract或者replicat 组。
file name:可以指定文件存放的位置， EDIT PARAMS c:\lpparms\replp.prm
4.8、ENCRYPT PASSWORD 加密密码
ENCRYPT PASSWORD password
[AES128 | AES192 | AES256 | BLOWFISH]
ENCRYPTKEY {key_name | DEFAULT}
默认使用AES128，
ENCRYPT PASSWORD Admin123 BLOWFISH ENCRYPTKEY superkey3
5.0、FLUSH SEQUENCE 在开始抽取初始化时候将更新序列使用。
FLUSH SEQUENCE scott.seq
5.6、 INFO ER 查看多个 Extract 和 Replicat 组。
INFO ER group_wildcard
[, SHOWCH checkpoints-number]
[, DETAIL]
[, TASKS]
[, ALLPROCESSES]
6.8、KILL ER 杀掉进程
KILL ER group_name
7.1、LAG 查看延迟统计信息。
LAG ER group_name
7.9、REGISTER EXTRACT 注册抽取，满足集成模式需要，
REGISTER EXTRACT group_name LOGRETENTION
REGISTER EXTRACT group-name>
( LOGRETENTION | DATABASE
( [ CONTAINER container-list |
ADD CONTAINER container-list |
DROP CONTAINER container-list ]
[ SCN scn ]
[ SHARE ( AUTOMATIC | group-name | NONE ) ]
[ [NO]OPTIMIZED ]
)
)
最后所有的文章参考：
https://docs.oracle.com/en/middleware/goldengate/core/19.1/books.html