数据结构

最近更新时间:2024-09-27 01:14:14

我的收藏

AdvancedObjectsItem

数据库不一致的详情,mongodb业务用到

被如下接口引用:DescribeCompareReport。

名称 类型 描述
ObjectType String 对象类型,可能得值有:account,index,shardkey,schema
注意:此字段可能返回 null,表示取不到有效值。
示例值:account
SrcChunk String 源端分块
注意:此字段可能返回 null,表示取不到有效值。
示例值:other.test
DstChunk String 目标端分块
注意:此字段可能返回 null,表示取不到有效值。
示例值:other.test
SrcItem String 源端值
注意:此字段可能返回 null,表示取不到有效值。
示例值:
DstItem String 目标端值
注意:此字段可能返回 null,表示取不到有效值。
示例值:

CheckStep

检查步骤

被如下接口引用:DescribeMigrationCheckJob。

名称 类型 描述
StepNo Integer 步骤编号
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
StepId String 步骤Id, 如:ConnectDBCheck、VersionCheck、SrcPrivilegeCheck等,具体校验项和源目标实例相关
注意:此字段可能返回 null,表示取不到有效值。
示例值:SrcPrivilegeCheck
StepName String 步骤名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:源实例权限检查
StepStatus String 此检查步骤的结果,pass(校验通过)、failed(校验失败)、notStarted(校验还未开始进行)、blocked(检验阻塞)、warning(校验有告警,但仍通过)
注意:此字段可能返回 null,表示取不到有效值。
示例值:pass
StepMessage String 此检查步骤的错误消息
注意:此字段可能返回 null,表示取不到有效值。
示例值:修改目标库session级别explicit_defaults_for_timestamp参数为ON失败
DetailCheckItems Array of DetailCheckItem 每个检查步骤里的具体检查项
注意:此字段可能返回 null,表示取不到有效值。
HasSkipped Boolean 是否已跳过
注意:此字段可能返回 null,表示取不到有效值。
示例值:false

CheckStepInfo

校验任务运行详情

被如下接口引用:DescribeMigrationDetail。

名称 类型 描述
StartAt String 任务开始时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 17:16:50
EndAt String 任务结束时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 17:16:50
Progress ProcessProgress 任务步骤信息
注意:此字段可能返回 null,表示取不到有效值。

Column

数据同步中的列信息

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs, ModifySyncJobConfig。

名称 类型 必选 描述
ColumnName String 列名
注意:此字段可能返回 null,表示取不到有效值。
示例值:c1
NewColumnName String 新列名
注意:此字段可能返回 null,表示取不到有效值。
示例值:c1_new

CompareAbstractInfo

一致性校验摘要信息

被如下接口引用:DescribeCompareReport。

名称 类型 描述
Options CompareOptions 校验配置参数
注意:此字段可能返回 null,表示取不到有效值。
Objects CompareObject 一致性校验对比对象
注意:此字段可能返回 null,表示取不到有效值。
Conclusion String 对比结论: same,different
注意:此字段可能返回 null,表示取不到有效值。
示例值:same
Status String 任务状态: success,failed
注意:此字段可能返回 null,表示取不到有效值。
示例值:success
TotalTables Integer 总的表数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:100
CheckedTables Integer 已校验的表数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:100
DifferentTables Integer 不一致的表数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
SkippedTables Integer 跳过校验的表数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
NearlyTableCount Integer 预估表总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:100
DifferentRows Integer 不一致的数据行数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
SrcSampleRows Integer 源库行数,当对比类型为行数对比时此项有意义
注意:此字段可能返回 null,表示取不到有效值。
示例值:100000
DstSampleRows Integer 目标库行数,当对比类型为行数对比时此项有意义
注意:此字段可能返回 null,表示取不到有效值。
示例值:100000
StartedAt String 开始时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-19 15:54:18
FinishedAt String 结束时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-19 15:58:18

CompareColumnItem

列选项

被如下接口引用:CreateCompareTask, DescribeCompareReport, ModifyCompareTask。

名称 类型 必选 描述
ColumnName String 列名
注意:此字段可能返回 null,表示取不到有效值。
示例值:c1

CompareDetailInfo

一致性校验详细信息

被如下接口引用:DescribeCompareReport。

名称 类型 描述
Difference DifferenceDetail 数据不一致的表详情
注意:此字段可能返回 null,表示取不到有效值。
Skipped SkippedDetail 跳过校验的表详情
注意:此字段可能返回 null,表示取不到有效值。
DifferenceAdvancedObjects DifferenceAdvancedObjectsDetail 数据库不一致的详情,mongodb业务用到
注意:此字段可能返回 null,表示取不到有效值。
DifferenceData DifferenceDataDetail 数据不一致的详情,mongodb业务用到
注意:此字段可能返回 null,表示取不到有效值。
DifferenceRow DifferenceRowDetail 数据行不一致的详情,mongodb业务用到
注意:此字段可能返回 null,表示取不到有效值。

CompareObject

一致性对比对象配置

被如下接口引用:CreateCompareTask, DescribeCompareReport, DescribeCompareTasks, ModifyCompareTask。

名称 类型 必选 描述
ObjectMode String 对象模式 整实例-all,部分对象-partial
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
ObjectItems Array of CompareObjectItem 对象列表
注意:此字段可能返回 null,表示取不到有效值。
AdvancedObjects Array of String 高级对象类型,如account(账号),index(索引),shardkey(片键,后面可能会调整),schema(库表结构)
注意:此字段可能返回 null,表示取不到有效值。
示例值:account

CompareObjectItem

一致性校验库表对象

被如下接口引用:CreateCompareTask, DescribeCompareReport, ModifyCompareTask。

名称 类型 必选 描述
DbName String 数据库名
注意:此字段可能返回 null,表示取不到有效值。
示例值:db1
DbMode String 数据库选择模式: all 为当前对象下的所有对象,partial 为部分对象
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
SchemaName String schema名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:schema1
TableMode String 表选择模式: all 为当前对象下的所有表对象,partial 为部分表对象
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
Tables Array of CompareTableItem 用于一致性校验的表配置,当 TableMode 为 partial 时,需要填写
注意:此字段可能返回 null,表示取不到有效值。
ViewMode String 视图选择模式: all 为当前对象下的所有视图对象,partial 为部分视图对象(一致性校验不校验视图,当前参数未启作用)
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
Views Array of CompareViewItem 用于一致性校验的视图配置,当 ViewMode 为 partial 时, 需要填写(一致性校验不校验视图,当前参数未启作用)
注意:此字段可能返回 null,表示取不到有效值。

CompareOptions

一致性校验选项

被如下接口引用:CreateCompareTask, DescribeCompareReport, DescribeCompareTasks, ModifyCompareTask。

名称 类型 必选 描述
Method String 对比方式:dataCheck(完整数据对比)、sampleDataCheck(抽样数据对比)、rowsCount(行数对比), 默认为dataCheck
注意:此字段可能返回 null,表示取不到有效值。
示例值:dataCheck
SampleRate Integer 抽样比例;范围0,100。默认为100
注意:此字段可能返回 null,表示取不到有效值。
示例值:100
ThreadCount Integer 线程数,取值1-5,默认为1
注意:此字段可能返回 null,表示取不到有效值。
示例值:1

CompareTableItem

用于一致性校验的表配置

被如下接口引用:CreateCompareTask, DescribeCompareReport, ModifyCompareTask。

名称 类型 必选 描述
TableName String 表名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1
ColumnMode String column 模式,all 为全部,partial 表示部分(该参数仅对数据同步任务有效)
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
Columns Array of CompareColumnItem 当 ColumnMode 为 partial 时必填(该参数仅对数据同步任务有效)
注意:此字段可能返回 null,表示取不到有效值。

CompareTaskInfo

数据一致性校验结果

被如下接口引用:DescribeMigrationDetail, DescribeMigrationJobs。

名称 类型 描述
CompareTaskId String 一致性校验任务Id
注意:此字段可能返回 null,表示取不到有效值。
示例值:dts-amm1jw5q-cmp-bmuum7jk
Status String 一致性校验结果,包括:unstart(未启动)、running(校验中)、canceled(已终止)、failed(校验任务失败)、inconsistent(不一致)、consistent(一致)、notexist(不存在校验任务)
注意:此字段可能返回 null,表示取不到有效值。
示例值:consistent

CompareTaskItem

一致性校验对象信息

被如下接口引用:DescribeCompareTasks。

名称 类型 描述
JobId String 任务id
注意:此字段可能返回 null,表示取不到有效值。
示例值:dts-e7ukka6g
CompareTaskId String 对比任务 Id
注意:此字段可能返回 null,表示取不到有效值。
示例值:dts-e7ukka6g-cmp-c7tnusmo
TaskName String 对比任务名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:test
Status String 对比任务状态, 可能的值:created - 创建完成;readyRun - 等待运行;running - 运行中;success - 成功;stopping - 结束中;failed - 失败;canceled - 已终止
注意:此字段可能返回 null,表示取不到有效值。
示例值:success
Config CompareObject 对比任务配置
注意:此字段可能返回 null,表示取不到有效值。
CheckProcess ProcessProgress 对比任务校验详情
注意:此字段可能返回 null,表示取不到有效值。
CompareProcess ProcessProgress 对比任务运行详情
注意:此字段可能返回 null,表示取不到有效值。
Conclusion String 对比结果, 可能的值:same - 一致;different - 不一致;skipAll - 跳过
注意:此字段可能返回 null,表示取不到有效值。
示例值:same
CreatedAt String 任务创建时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 17:26:40
StartedAt String 任务启动时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 17:26:40
FinishedAt String 对比结束时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 17:26:40
Method String 对比类型,dataCheck(完整数据对比)、sampleDataCheck(抽样数据对比)、rowsCount(行数对比)
注意:此字段可能返回 null,表示取不到有效值。
示例值:dataCheck
Options CompareOptions 对比配置信息
注意:此字段可能返回 null,表示取不到有效值。
Message String 一致性校验提示信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:success

CompareViewItem

用于一致性校验的视图配置

被如下接口引用:CreateCompareTask, DescribeCompareReport, ModifyCompareTask。

名称 类型 必选 描述
ViewName String 视图名
注意:此字段可能返回 null,表示取不到有效值。
示例值:view1

ConflictHandleOption

冲突处理里的详细描述

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs, ModifySyncJobConfig。

名称 类型 必选 描述
ConditionColumn String 条件覆盖的列
注意:此字段可能返回 null,表示取不到有效值。
示例值:c1
ConditionOperator String 条件覆盖操作
注意:此字段可能返回 null,表示取不到有效值。
示例值:>
ConditionOrderInSrcAndDst String 条件覆盖优先级处理
注意:此字段可能返回 null,表示取不到有效值。
示例值:>

ConsistencyOption

数据一致性校验选项, 默认为不开启一致性校验

被如下接口引用:DescribeMigrationDetail, ModifyMigrationJob。

名称 类型 必选 描述
Mode String 一致性检测类型: full(全量检测迁移对象)、noCheck(不检测)、notConfigured(未配置)
注意:此字段可能返回 null,表示取不到有效值。
示例值:noCheck

DBEndpointInfo

实例信息

被如下接口引用:DescribeMigrationDetail, DescribeMigrationJobs, ModifyMigrationJob。

名称 类型 必选 描述
Region String 实例所在地域
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-guangzhou
AccessType String 实例网络接入类型,如:extranet(外网)、ipv6(公网ipv6)、cvm(云主机自建)、dcg(专线接入)、vpncloud(vpn接入的实例)、cdb(云数据库)、ccn(云联网)、intranet(自研上云)、vpc(私有网络)等,注意具体可选值依赖当前链路
注意:此字段可能返回 null,表示取不到有效值。
示例值:cdb
DatabaseType String 实例数据库类型,如:mysql,redis,mongodb,postgresql,mariadb,percona 等
注意:此字段可能返回 null,表示取不到有效值。
示例值:mysql
NodeType String 节点类型,为空或者simple表示普通节点、cluster表示集群节点;对于mongo业务,取值为replicaset(mongodb副本集)、standalone(mongodb单节点)、cluster(mongodb集群);对于redis实例,为空或simple(单节点)、cluster(集群)、cluster-cache(cache集群)、cluster-proxy(代理集群)
注意:此字段可能返回 null,表示取不到有效值。
示例值:simple
Info Array of DBInfo 数据库信息
注意:此字段可能返回 null,表示取不到有效值。
Supplier String 实例服务提供商,如:"aliyun","others"
注意:此字段可能返回 null,表示取不到有效值。
示例值:others
ExtraAttr Array of KeyValuePairOption MongoDB可定义如下的参数: ['AuthDatabase':'admin',
'AuthFlag': "1", 'AuthMechanism':"SCRAM-SHA-1"]
注意:此字段可能返回 null,表示取不到有效值。
DatabaseNetEnv String 数据库所属网络环境,AccessType为云联网(ccn)时必填, UserIDC表示用户IDC、TencentVPC表示腾讯云VPC;
注意:此字段可能返回 null,表示取不到有效值。
示例值:TencentVPC
ConnectType String tdsql连接方式:proxy-通过tdsql proxy主机访问各个set节点,注意只有在自研上云的网络环境下才能通过这种方式连接,Info中只需要提供proxy主机信息。set-直连set节点,如选择直连set方式,Info中需要正确填写proxy主机信息及所有set节点信息。源端是tdsqlmysql类型必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:proxy

DBInfo

数据库信息

被如下接口引用:DescribeMigrationDetail, DescribeMigrationJobs, ModifyMigrationJob。

名称 类型 必选 描述
Role String 表示节点角色,针对分布式数据库,如mongodb中的mongos节点。tdsqlmysql的可选项:proxy表示节点类型为主机,set表示节点类型为节点。proxy类型必须填在数组第一项。tdsqlmysql类型的源/目标配置必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:mongos
DbKernel String 内核版本,针对mariadb的不同内核版本等
注意:此字段可能返回 null,表示取不到有效值。
示例值:mysql
Host String 实例的IP地址,对于公网、专线、VPN、云联网、自研上云、VPC等接入方式此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:192.2.3.4
Port Integer 实例的端口,对于公网、云主机自建、专线、VPN、云联网、自研上云、VPC等接入方式此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:3306
User String 实例的用户名
注意:此字段可能返回 null,表示取不到有效值。
示例值:root
Password String 实例的密码
注意:此字段可能返回 null,表示取不到有效值。
示例值:password
CvmInstanceId String CVM实例短ID,格式如:ins-olgl39y8;与云服务器控制台页面显示的实例ID相同;如果接入类型为云主机自建的方式,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:ins-olgl39y8
UniqVpnGwId String VPN网关ID,格式如:vpngw-9ghexg7q;如果接入类型为vpncloud的方式,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:vpngw-9ghexg7q
UniqDcgId String 专线网关ID,格式如:dcg-0rxtqqxb;如果接入类型为专线接入的方式,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:dcg-0rxtqqxb
InstanceId String 数据库实例ID,格式如:cdb-powiqx8q;如果接入类型为云数据库的方式,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:cdb-powiqx8q
CcnGwId String 云联网ID,如:ccn-afp6kltc 注意:此字段可能返回 null,表示取不到有效值。
注意:此字段可能返回 null,表示取不到有效值。
示例值:ccn-afp6kltc
VpcId String 私有网络ID,格式如:vpc-92jblxto;如果接入类型为vpc、vpncloud、ccn、dcg的方式,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:vpc-92jblxto
SubnetId String 私有网络下的子网ID,格式如:subnet-3paxmkdz;如果接入类型为vpc、vpncloud、ccn、dcg的方式,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:subnet-3paxmkdz
EngineVersion String 数据库版本,当实例为RDS实例时才有效,格式如:5.6或者5.7,默认为5.6
注意:此字段可能返回 null,表示取不到有效值。
示例值:5.6
Account String 实例所属账号
注意:此字段可能返回 null,表示取不到有效值。
示例值:700000123456
AccountRole String 跨账号迁移时的角色,只允许[a-zA-Z0-9-_]+
注意:此字段可能返回 null,表示取不到有效值。
示例值:role
AccountMode String 资源所属账号 为空或self(表示本账号内资源)、other(表示其他账户资源)
注意:此字段可能返回 null,表示取不到有效值。
示例值:self
TmpSecretId String 临时密钥Id,可通过申请扮演角色临时访问凭证获取临时密钥https://cloud.tencent.com/document/product/1312/48197,其中角色资源RoleArn的定义可参考DTS跨账号迁移文档(https://cloud.tencent.com/document/product/571/54117)第4节中关于角色的定义。
注意:此字段可能返回 null,表示取不到有效值。
示例值:AKID5XXXXX
TmpSecretKey String 临时密钥Id,可通过申请扮演角色临时访问凭证获取临时密钥https://cloud.tencent.com/document/product/1312/48197,其中角色资源RoleArn的定义可参考DTS跨账号迁移文档(https://cloud.tencent.com/document/product/571/54117)第4节中关于角色的定义。
注意:此字段可能返回 null,表示取不到有效值。
示例值:2qZDsXXXXX
TmpToken String 临时密钥Id,可通过申请扮演角色临时访问凭证获取临时密钥https://cloud.tencent.com/document/product/1312/48197,其中角色资源RoleArn的定义可参考DTS跨账号迁移文档(https://cloud.tencent.com/document/product/571/54117)第4节中关于角色的定义。
注意:此字段可能返回 null,表示取不到有效值。
示例值:NRUkuXXXXX
SetId String tdsql的分片id。如节点类型为set必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:set_1693279393_1

DBItem

迁移对象信息,在配置库表视图等对象信息时大小写敏感

被如下接口引用:DescribeMigrationDetail, ModifyMigrationJob。

名称 类型 必选 描述
DbName String 需要迁移或同步的库名,当ObjectMode为partial时,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:db1
NewDbName String 迁移或同步后的库名,默认与源库相同
注意:此字段可能返回 null,表示取不到有效值。
示例值:db1_new
SchemaName String 迁移或同步的 schema
注意:此字段可能返回 null,表示取不到有效值。
示例值:schema1
NewSchemaName String 迁移或同步后的 schema name
注意:此字段可能返回 null,表示取不到有效值。
示例值:schema1_new
DBMode String DB选择模式: all(为当前对象下的所有对象),partial(部分对象),当ObjectMode为partial时,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
SchemaMode String schema选择模式: all(为当前对象下的所有对象),partial(部分对象)
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
TableMode String 表选择模式: all(为当前对象下的所有对象),partial(部分对象),当DBMode为partial时此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
Tables Array of TableItem 表图对象集合,当 TableMode 为 partial 时,此项需要填写
注意:此字段可能返回 null,表示取不到有效值。
ViewMode String 视图选择模式: all 为当前对象下的所有视图对象,partial 为部分视图对象
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
Views Array of ViewItem 视图对象集合,当 ViewMode 为 partial 时, 此项需要填写
注意:此字段可能返回 null,表示取不到有效值。
RoleMode String postgresql独有参数,角色选择模式: all 为当前对象下的所有角色对象,partial 为部分角色对象
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
Roles Array of RoleItem postgresql独有参数,当 RoleMode 为 partial 时, 此项需要填写
注意:此字段可能返回 null,表示取不到有效值。
FunctionMode String 选择要同步的模式,partial为部分,all为整选
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
TriggerMode String 选择要同步的模式,partial为部分,all为整选
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
EventMode String 选择要同步的模式,partial为部分,all为整选
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
ProcedureMode String 选择要同步的模式,partial为部分,all为整选
注意:此字段可能返回 null,表示取不到有效值。
示例值:all
Functions Array of String FunctionMode取值为partial时需要填写
注意:此字段可能返回 null,表示取不到有效值。
示例值:["function_name"]
Procedures Array of String ProcedureMode取值为partial时需要填写
注意:此字段可能返回 null,表示取不到有效值。
示例值:["procedure_name"]
Events Array of String EventMode取值为partial时需要填写
注意:此字段可能返回 null,表示取不到有效值。
示例值:["event_name"]
Triggers Array of String TriggerMode取值为partial时需要填写
注意:此字段可能返回 null,表示取不到有效值。
示例值:["trigger_name"]

Database

需要同步的库表对象

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs, ModifySyncJobConfig。

名称 类型 必选 描述
DbName String 需要迁移或同步的库名,当ObjectMode为Partial时,此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:db1
NewDbName String 迁移或同步后的库名,默认与源库相同
注意:此字段可能返回 null,表示取不到有效值。
示例值:db1_new
DbMode String DB选择模式: All(为当前对象下的所有对象),Partial(部分对象),当Mode为Partial时,此项必填。注意,高级对象的同步不依赖此值,如果整库同步此处应该为All。
注意:此字段可能返回 null,表示取不到有效值。
示例值:All
SchemaName String 迁移或同步的 schema
注意:此字段可能返回 null,表示取不到有效值。
示例值:sch1
NewSchemaName String 迁移或同步后的 schema name
注意:此字段可能返回 null,表示取不到有效值。
示例值:sch1_new
TableMode String 表选择模式: All(为当前对象下的所有对象),Partial(部分对象),当DBMode为Partial时此项必填,如果整库同步此处应该为All。
注意:此字段可能返回 null,表示取不到有效值。
示例值:All
Tables Array of Table 表图对象集合,当 TableMode 为 Partial 时,此项需要填写
注意:此字段可能返回 null,表示取不到有效值。
ViewMode String 视图选择模式: All 为当前对象下的所有视图对象,Partial 为部分视图对象,如果整库同步此处应该为All。
注意:此字段可能返回 null,表示取不到有效值。
示例值:All
Views Array of View 视图对象集合,当 ViewMode 为 Partial 时, 此项需要填写
注意:此字段可能返回 null,表示取不到有效值。
FunctionMode String 选择要同步的模式,Partial为部分,All为整选,如果整库同步此处应该为All。
注意:此字段可能返回 null,表示取不到有效值。
示例值:All
Functions Array of String FunctionMode取值为Partial时需要填写
注意:此字段可能返回 null,表示取不到有效值。
示例值:["func_1"]
ProcedureMode String 选择要同步的模式,Partial为部分,All为整选,如果整库同步此处应该为All。
注意:此字段可能返回 null,表示取不到有效值。
示例值:All
Procedures Array of String ProcedureMode取值为Partial时需要填写
注意:此字段可能返回 null,表示取不到有效值。
示例值:["proc_1"]
TriggerMode String 触发器迁移模式,All(为当前对象下的所有对象),Partial(部分对象),如果整库同步此处应该为All。数据同步暂不支持此高级对象。
注意:此字段可能返回 null,表示取不到有效值。
示例值:Partial
Triggers Array of String 当TriggerMode为partial,指定要迁移的触发器名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:["trigger_1"]
EventMode String 事件迁移模式,All(为当前对象下的所有对象),Partial(部分对象),如果整库同步此处应该为All。数据同步暂不支持此高级对象。
注意:此字段可能返回 null,表示取不到有效值。
示例值:Partial
Events Array of String 当EventMode为partial,指定要迁移的事件名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:["event_1"]

DatabaseTableObject

迁移对象选项,需要告知迁移服务迁移哪些库表对象

被如下接口引用:DescribeMigrationDetail, ModifyMigrationJob。

名称 类型 必选 描述
ObjectMode String 迁移对象类型 all(全实例),partial(部分对象)
注意:此字段可能返回 null,表示取不到有效值。
示例值:partial
Databases Array of DBItem 迁移对象,当 ObjectMode 为 partial 时,不为空
注意:此字段可能返回 null,表示取不到有效值。
AdvancedObjects Array of String 高级对象类型,如trigger、function、procedure、event。注意:如果要迁移同步高级对象,此配置中应该包含对应的高级对象类型
注意:此字段可能返回 null,表示取不到有效值。
示例值:["trigger"]

DdlOption

数据同步中的ddl同步处理

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs, ModifySyncJobConfig。

名称 类型 必选 描述
DdlObject String ddl类型,如Database,Table,View,Index等
注意:此字段可能返回 null,表示取不到有效值。
示例值:Database
DdlValue Array of String ddl具体值,对于Database可取值[Create,Drop,Alter]
对于Table可取值[Create,Drop,Alter,Truncate,Rename]
对于View可取值[Create,Drop]
对于Index可取值[Create,Drop]
注意:此字段可能返回 null,表示取不到有效值。
示例值:Alter

DetailCheckItem

每个检查步骤里的具体检查项

被如下接口引用:DescribeMigrationCheckJob。

名称 类型 描述
CheckItemName String 检查项的名称,如:源实例权限检查
注意:此字段可能返回 null,表示取不到有效值。
示例值:周边检查
Description String 检查项详细内容
注意:此字段可能返回 null,表示取不到有效值。
示例值:周边检查
CheckResult String pass(通过),failed(失败), warning(校验有警告,但仍通过)
注意:此字段可能返回 null,表示取不到有效值。
示例值:failed
FailureReason String 检查项失败原因
注意:此字段可能返回 null,表示取不到有效值。
示例值:如果目标库explicit_defaults_for_timestamp参数不为ON,timestamp列的隐式转换规则可能会导致源库和目标库结构不一致
Solution String 解决方案
注意:此字段可能返回 null,表示取不到有效值。
示例值:尝试以下两种方式任意一种即可:1.xxx,2xxx
ErrorLog Array of String 运行报错日志
注意:此字段可能返回 null,表示取不到有效值。
示例值:修改目标库session级别explicit_defaults_for_timestamp参数为ON失败,错误信息详情 failed to run query set explicit_defaults_for_timestamp = on, err: Error 1227: Access denied; you need (at least one of) the SUPER privilege(s) for this operation
HelpDoc Array of String 详细帮助的文档链接
注意:此字段可能返回 null,表示取不到有效值。
示例值:周边检查: cloud.tencent.com/document/product/571/58690
SkipInfo String 跳过风险文案
注意:此字段可能返回 null,表示取不到有效值。
示例值:如果目标库explicit_defaults_for_timestamp参数不为ON,timestamp列的隐式转换规则可能会导致源库和目标库结构不一致

DifferenceAdvancedObjectsDetail

数据库不一致的详情,mongodb业务用到

被如下接口引用:DescribeCompareReport。

名称 类型 描述
TotalCount Integer 总数
注意:此字段可能返回 null,表示取不到有效值。
Items Array of AdvancedObjectsItem 不一致详情
注意:此字段可能返回 null,表示取不到有效值。

DifferenceData

数据不一致详情

被如下接口引用:DescribeCompareReport。

名称 类型 描述
Db String 数据库名
注意:此字段可能返回 null,表示取不到有效值。
示例值:user_c
Table String 集合
注意:此字段可能返回 null,表示取不到有效值。
示例值:user_s
SrcChunk String 源端ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:ObjectID("626cb354184dd55f78b95f7f")
DstChunk String 目标端ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:ObjectID("626cb354184dd55f78b95f7f")
SrcItem String 源端值
注意:此字段可能返回 null,表示取不到有效值。
示例值:{"$numberInt":"17"}
DstItem String 目标端值
注意:此字段可能返回 null,表示取不到有效值。
示例值:{"$numberInt":"18"}
UpdatedAt String 更新时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-10-26 18:54:40

DifferenceDataDetail

mongodb数据不一致性详情

被如下接口引用:DescribeCompareReport。

名称 类型 描述
TotalCount Integer 总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
Items Array of DifferenceData mongo数据不一致详细列表
注意:此字段可能返回 null,表示取不到有效值。

DifferenceDetail

数据不一致的表详情

被如下接口引用:DescribeCompareReport。

名称 类型 描述
TotalCount Integer 数据不一致的表数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Items Array of DifferenceItem 校验不一致的表详情
注意:此字段可能返回 null,表示取不到有效值。

DifferenceItem

校验不一致的表详情

被如下接口引用:DescribeCompareReport。

名称 类型 描述
Db String 数据库名
注意:此字段可能返回 null,表示取不到有效值。
示例值:db1
Table String 表名
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1
Chunk Integer 分块号
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
SrcItem String 源库数值
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
DstItem String 目标库数值
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
IndexName String 索引名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:PRIMARY
LowerBoundary String 索引下边界
注意:此字段可能返回 null,表示取不到有效值。
示例值:["1","1","2023-12-26"]
UpperBoundary String 索引上边界
注意:此字段可能返回 null,表示取不到有效值。
示例值:["+inf"]
CostTime Float 对比消耗时间,单位为 ms
注意:此字段可能返回 null,表示取不到有效值。
示例值:0.48
FinishedAt String 完成时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-26 05:14:24

DifferenceRowDetail

mongodb行数校验不一致性详情结果

被如下接口引用:DescribeCompareReport。

名称 类型 描述
TotalCount Integer 不一致总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:100
Items Array of RowsCountDifference 不一致列表
注意:此字段可能返回 null,表示取不到有效值。

DistributeRule

订阅任务的kafka分区规则。符合库名和表名正则表达式的数据将按照RuleType计算该条数据将被投递的kafka分区。如果配置了多个规则,将按照配置的顺序,第一条命中的规则生效。

被如下接口引用:ConfigureSubscribeJob, DescribeSubscribeDetail, ModifySubscribeObjects。

名称 类型 必选 描述
RuleType String 规则类型。非mongo产品的枚举值为: table-按表名分区,pk-按表名+主键分区,cols-按列名分区。mongo的枚举值为:collection-按集合名分区、collectionAndObjectId-按集合+主键分区。
注意:此字段可能返回 null,表示取不到有效值。
示例值:table
DbPattern String 库名匹配规则,请填写正则表达式
注意:此字段可能返回 null,表示取不到有效值。
示例值:test*
TablePattern String 表名匹配规则,如果 DatabaseType 为 mongodb,则匹配集合名
注意:此字段可能返回 null,表示取不到有效值。
示例值:*
Columns Array of String 列名。如果 RuleType 为 cols,此项必填。订阅任务会用该列的值计算分区。mongo没有按列分区,因此也不用传这个字段。
注意:此字段可能返回 null,表示取不到有效值。
示例值:id

DynamicOptions

数据同步中的选项

被如下接口引用:ModifySyncJobConfig。

名称 类型 必选 描述
OpTypes Array of String 所要同步的DML和DDL的选项,Insert(插入操作)、Update(更新操作)、Delete(删除操作)、DDL(结构同步),PartialDDL(自定义,和DdlOptions一起起作用 );必填、dts会用该值覆盖原有的值
注意:此字段可能返回 null,表示取不到有效值。
示例值:["Insert"]
DdlOptions Array of DdlOption DDL同步选项,具体描述要同步那些DDL; 当OpTypes取值PartialDDL时、字段不能为空;必填、dts会用该值覆盖原有的值
注意:此字段可能返回 null,表示取不到有效值。
ConflictHandleType String 冲突处理选项,ReportError(报错)、Ignore(忽略)、Cover(覆盖)、ConditionCover(条件覆盖); 目前目标端为kafka的链路不支持修改该配置
注意:此字段可能返回 null,表示取不到有效值。
示例值:ReportError
ConflictHandleOption ConflictHandleOption 冲突处理的详细选项,如条件覆盖中的条件行和条件操作;不能部分更新该选项的内部字段;有更新时、需要全量更新该字段
注意:此字段可能返回 null,表示取不到有效值。

Endpoint

数据同步中的描述源端和目的端的信息

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs。

名称 类型 必选 描述
Region String 地域英文名,如:ap-guangzhou
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-guangzhou
Role String 节点类型,proxy表示节点类型为主机,set表示节点类型为节点。proxy类型必须填在数组第一项。tdsqlmysql类型的源/目标配置必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:proxy
DbKernel String 数据库内核类型,tdsql中用于区分不同内核:percona,mariadb,mysql。注意TDSQL-C MySQL、TDSQL PostgreSQL无需填写此项值。
注意:此字段可能返回 null,表示取不到有效值。
示例值:mariadb
InstanceId String 数据库实例ID,格式如:cdb-powiqx8q
注意:此字段可能返回 null,表示取不到有效值。
示例值:cdb-wew23ed
Ip String 实例的IP地址,接入类型为非cdb时此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:192.168.1.12
Port Integer 实例端口,接入类型为非cdb时此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:3306
User String 用户名,对于访问需要用户名密码认证的实例必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:user
Password String 密码,对于访问需要用户名密码认证的实例必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:1234
DbName String 数据库名,数据库为cdwpg时,需要提供
注意:此字段可能返回 null,表示取不到有效值。
示例值:postgress
VpcId String 私有网络ID,对于私有网络、专线、VPN的接入方式此项必填,格式如:vpc-92jblxto
注意:此字段可能返回 null,表示取不到有效值。
示例值:vpc-23rwfdg
SubnetId String 私有网络下的子网ID,对于私有网络、专线、VPN的接入方式此项必填,格式如:subnet-3paxmkdz
注意:此字段可能返回 null,表示取不到有效值。
示例值:subnet-tke9sfg
CvmInstanceId String CVM实例短ID,格式如:ins-olgl39y8,与云服务器控制台页面显示的实例ID相同。如果是CVM自建实例,需要传递此字段
注意:此字段可能返回 null,表示取不到有效值。
示例值:ins-9emwf2d
UniqDcgId String 专线网关ID,对于专线接入类型此项必填,格式如:dcg-0rxtqqxb
注意:此字段可能返回 null,表示取不到有效值。
示例值:dcg-9sdfksk
UniqVpnGwId String VPN网关ID,对于vpn接入类型此项必填,格式如:vpngw-9ghexg7q
注意:此字段可能返回 null,表示取不到有效值。
示例值:vpngw-3dsfwf2
CcnId String 云联网ID,对于云联网接入类型此项必填,如:ccn-afp6kltc
注意:此字段可能返回 null,表示取不到有效值。
示例值:ccn-afp6kltc
Supplier String 云厂商类型,当实例为RDS实例时,填写为aliyun, 其他情况均填写others,默认为others
注意:此字段可能返回 null,表示取不到有效值。
示例值:aliyun
EngineVersion String 数据库版本,当实例为RDS实例时才有效,其他实例忽略,格式如:5.6或者5.7,默认为5.6
注意:此字段可能返回 null,表示取不到有效值。
示例值:5.6
Account String 实例所属账号,如果为跨账号实例此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:700000123456
AccountMode String 资源所属账号 为空或self(表示本账号内资源)、other(表示跨账号资源)
注意:此字段可能返回 null,表示取不到有效值。
示例值:other
AccountRole String 跨账号同步时的角色,只允许[a-zA-Z0-9-_]+,如果为跨账号实例此项必填
注意:此字段可能返回 null,表示取不到有效值。
示例值:dts test_role
RoleExternalId String 外部角色id
注意:此字段可能返回 null,表示取不到有效值。
示例值:roleId
TmpSecretId String 临时密钥Id,可通过申请扮演角色临时访问凭证获取临时密钥https://cloud.tencent.com/document/product/1312/48197,其中角色资源RoleArn的定义可参考DTS跨账号同步文档(https://cloud.tencent.com/document/product/571/68729)第4节中关于角色的定义。
注意:此字段可能返回 null,表示取不到有效值。
示例值:AKID5XXXXX
TmpSecretKey String 临时密钥Id,可通过申请扮演角色临时访问凭证获取临时密钥https://cloud.tencent.com/document/product/1312/48197,其中角色资源RoleArn的定义可参考DTS跨账号同步文档(https://cloud.tencent.com/document/product/571/68729)第4节中关于角色的定义。
注意:此字段可能返回 null,表示取不到有效值。
示例值:2qZDXXXXX
TmpToken String 临时密钥Id,可通过申请扮演角色临时访问凭证获取临时密钥https://cloud.tencent.com/document/product/1312/48197,其中角色资源RoleArn的定义可参考DTS跨账号同步文档(https://cloud.tencent.com/document/product/571/68729)第4节中关于角色的定义。
注意:此字段可能返回 null,表示取不到有效值。
示例值:JOqqCXXXXX
EncryptConn String 是否走加密传输、UnEncrypted表示不走加密传输,Encrypted表示走加密传输,默认UnEncrypted
注意:此字段可能返回 null,表示取不到有效值。
示例值:UnEncrypted
DatabaseNetEnv String 数据库所属网络环境,AccessType为云联网(ccn)时必填, UserIDC表示用户IDC、TencentVPC表示腾讯云VPC;
注意:此字段可能返回 null,表示取不到有效值。
示例值:TencentVPC
CcnOwnerUin String 数据库为跨账号云联网下的实例时、表示云联网所属主账号
注意:此字段可能返回 null,表示取不到有效值。
示例值:700000123456
ChildInstanceId String 数据库为cynos、且是cynos集群内的一个子数据库实例时、该参数为该子实例的ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:cynos-ins-xxxx
ChildInstanceType String 数据库为cynos、且是cynos集群内的一个子数据库实例时、该参数为该子实例的类型、例如:只读实例传ro、读写实例传rw
注意:此字段可能返回 null,表示取不到有效值。
示例值:ro
SetId String tdsql的分片id。如节点类型为set必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:set_1693279393_1(s1)

EndpointItem

数据订阅的实例节点信息

被如下接口引用:ConfigureSubscribeJob, DescribeSubscribeDetail, DescribeSubscribeJobs。

名称 类型 必选 描述
DatabaseRegion String 源库所在地域。如果 AccessType 为 ccn,请填vpc所在地域,因为此时不知道源库在哪个地域。其他接入方式,请填订阅任务所在地域,因为确保订阅任务与源库在同一地域是最优的网络方案。
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-guangzhou
User String 用户名
注意:此字段可能返回 null,表示取不到有效值。
示例值:dts_user
Password String 密码。作为入参时必填,作为出参时为空。
注意:此字段可能返回 null,表示取不到有效值。
示例值:123
InstanceId String 目标实例ID。如果 AccessType 为 cdb,此项必填。配置InstanceId时会查询并校验实例信息。mysql的查询接口经过了鉴权,请确保子用户有 cdb:DescribeDBInstances 的接口权限。
注意:此字段可能返回 null,表示取不到有效值。
示例值:cdb-xxxxxx
CvmInstanceId String 云主机ID。如果 AccessType 为 cvm,此项必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:ins-xxxxxx
UniqDcgId String 专线网关ID。如果 AccessType 为 dcg,此项必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:dcg-xxxxxx
CcnId String 云联网ID。如果 AccessType 为 ccn,此项必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:ccn-xxxxxx
UniqVpnGwId String vpn网关ID。如果 AccessType 为 vpncloud,此项必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:vpngw-xxxxxx
VpcId String VpcID。如果 AccessType 为 dcg\ccn\vpncloud\vpc,此项必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:vpc-xxxxxx
SubnetId String 子网ID。如果 AccessType 为 dcg\ccn\vpncloud\vpc,此项必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:subnet-xxxxxx
HostName String 数据库地址,支持域名与IP。如果 AccessType 为 dcg\ccn\vpncloud\vpc\extranet\intranet,此项必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:9.223.70.88
Port Integer 数据库端口。如果 AccessType 为 dcg\ccn\vpncloud\vpc\extranet\intranet\cvm,此项必填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:3306
EncryptConn String 是否走加密传输,枚举值:UnEncrypted-不加密,Encrypted-加密。只有mysql支持,不填默认不加密,其他产品不填。
注意:此字段可能返回 null,表示取不到有效值。
示例值:Encrypted
DatabaseNetEnv String 数据库网络环境。如果 AccessType 为 ccn 此项必填。枚举值:UserIDC-自建idc,TencentVPC-腾讯云,Aws-aws,AliYun-阿里云,Others-其他。
注意:此字段可能返回 null,表示取不到有效值。
示例值:TencentVPC
CcnOwnerUin String 云联网网关所属的主账号uin、跨账号云联网需要。
注意:此字段可能返回 null,表示取不到有效值。
ExtraAttr Array of KeyValuePairOption 为业务添加的额外信息。参数名作key,参数值作value。 tdpg必填参数:PgDatabase-订阅的库名。
注意:此字段可能返回 null,表示取不到有效值。
ChildInstanceId String 数据库为cynos、且是cynos集群内的一个子数据库实例时、该参数为该子实例的ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:cynos-ins-xxxx
ChildInstanceType String 数据库为cynos、且是cynos集群内的一个子数据库实例时、该参数为该子实例的类型、例如:只读实例传ro、读写实例传rw
注意:此字段可能返回 null,表示取不到有效值。
示例值:ro

ErrInfo

错误信息及其解决方案

被如下接口引用:DescribeSyncJobs。

名称 类型 描述
Reason String 错误原因
示例值:连接源或者目标实例出现网络错误。
Message String 错误信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:dial tcp : i/o timeout
Solution String 解决方案
注意:此字段可能返回 null,表示取不到有效值。
示例值:请检查是否存在以上情况并解决。

ErrorInfoItem

任务错误信息

被如下接口引用:DescribeMigrationDetail。

名称 类型 描述
Code String 错误码
注意:此字段可能返回 null,表示取不到有效值。
示例值:ResourceNotFound
Solution String 解决方案
注意:此字段可能返回 null,表示取不到有效值。
示例值:请确认库表存在后重试
ErrorLog String 错误日志信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:execute fail: Error 1146: Table 'tencentdb.eg_dts-4lcse9uh' doesn't exist
HelpDoc String 文档提示
注意:此字段可能返回 null,表示取不到有效值。
示例值:请确认库表存在后重试

GroupInfo

kafka消费者组详情

被如下接口引用:DescribeConsumerGroups。

名称 类型 描述
Account String 消费者组账号
示例值:account-subs-47damshnra-3
ConsumerGroupName String 消费者组名称
示例值:consumer-grp-subs-47damshnra-3
Description String 消费者组备注
注意:此字段可能返回 null,表示取不到有效值。
ConsumerGroupOffset Integer 消费组偏移量。该字段是为了兼容以前单Partition的情况,取值为最后一个分区的偏移量。各分区的偏移量详见StateOfPartition字段
示例值:-1
ConsumerGroupLag Integer 消费组未消费的数据量。该字段是为了兼容以前单Partition的情况,取值为最后一个分区未消费的数据量。各分区未消费数据量详见StateOfPartition字段
示例值:0
Latency Integer 消费延迟(单位为秒)
示例值:9
StateOfPartition Array of MonitorInfo 各分区的消费状态
CreatedAt String 消费者组创建时间,格式为YYYY-MM-DD hh:mm:ss
示例值:2022-03-25 17:31:31
UpdatedAt String 消费者组修改时间,格式为YYYY-MM-DD hh:mm:ss
示例值:2022-03-25 17:31:31
ConsumerGroupState String 消费者组状态,包括Dead、Empty、Stable等,只有Dead和Empty两种状态可以执行reset操作
示例值:Stable
PartitionAssignment Array of PartitionAssignment 每个消费者正在消费的分区
注意:此字段可能返回 null,表示取不到有效值。

JobItem

迁移任务列表

被如下接口引用:DescribeMigrationJobs。

名称 类型 描述
JobId String 数据迁移任务ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:dts-amm1jw5q
JobName String 数据迁移任务名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:dts-amm1jw5q
CreateTime String 任务创建(提交)时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 16:20:49
UpdateTime String 任务更新时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 16:20:49
StartTime String 任务开始执行时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 16:20:49
EndTime String 任务执行结束时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 16:20:49
BriefMsg String 迁移任务错误信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:execute fail: Error 1146: Table 'tencentdb.eg_dts-4lcse9uh' doesn't exist
Status String 任务状态,取值为:creating(创建中)、created(创建完成)、checking(校验中)、checkPass(校验通过)、checkNotPass(校验不通过)、readyRun(准备运行)、running(任务运行)、readyComplete(准备完成)、success(任务成功)、failed(任务失败)、stopping(中止中)、completing(完成中)、
pausing(暂停中)、
manualPaused(已暂停)
注意:此字段可能返回 null,表示取不到有效值。
示例值:created
RunMode String 任务运行模式,值包括:immediate(立即运行),timed(定时运行)
注意:此字段可能返回 null,表示取不到有效值。
示例值:immediate
ExpectRunTime String 期待启动时间,当RunMode取值为timed时,此值必填,形如:2022-07-11 16:20:49
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 16:20:49
Action MigrateAction 任务操作信息
注意:此字段可能返回 null,表示取不到有效值。
StepInfo MigrateDetailInfo 迁移执行过程信息
注意:此字段可能返回 null,表示取不到有效值。
SrcInfo DBEndpointInfo 源实例信息
注意:此字段可能返回 null,表示取不到有效值。
DstInfo DBEndpointInfo 目标端信息
注意:此字段可能返回 null,表示取不到有效值。
CompareTask CompareTaskInfo 数据一致性校验结果
注意:此字段可能返回 null,表示取不到有效值。
TradeInfo TradeInfo 计费状态信息
注意:此字段可能返回 null,表示取不到有效值。
Tags Array of TagItem 标签信息
注意:此字段可能返回 null,表示取不到有效值。
AutoRetryTimeRangeMinutes Integer 自动重试时间段信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:5
DumperResumeCtrl String 全量导出可重入标识:enum::"yes"/"no"。yes表示当前任务可重入、no表示当前任务处于全量导出且不可重入阶段;如果在该值为no时重启任务导出流程不支持断点续传
注意:此字段可能返回 null,表示取不到有效值。
示例值:yes

KafkaOption

目标端为kakfa时添加的同步选项字段

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs。

名称 类型 必选 描述
DataType String 投递到kafka的数据类型,如Avro,Json,canal-pb,canal-json
示例值:Avro,Json
TopicType String 同步topic策略,如Single(集中投递到单topic),Multi (自定义topic名称)
示例值:Single(集中投递到单topic),Multi (自定义topic名称)
DDLTopicName String 用于存储ddl的topic
示例值:test
TopicRules Array of TopicRule 单topic和自定义topic的描述

KeyValuePairOption

存放配置时的额外信息

被如下接口引用:ConfigureSubscribeJob, DescribeMigrationDetail, DescribeMigrationJobs, DescribeSubscribeDetail, ModifyMigrateRuntimeAttribute, ModifyMigrationJob。

名称 类型 必选 描述
Key String 选项key
注意:此字段可能返回 null,表示取不到有效值。
示例值:AuthMechanism
Value String 选项value
注意:此字段可能返回 null,表示取不到有效值。
示例值:SCRAM-SHA-1

MigrateAction

任务操作信息,包含迁移任务的所有操作列表,及迁移任务在当前状态下允许的操作列表

被如下接口引用:DescribeMigrationDetail, DescribeMigrationJobs。

名称 类型 描述
AllAction Array of String 任务的所有操作列表
注意:此字段可能返回 null,表示取不到有效值。
示例值:["view","modify","check","start","configure","stop","complete","
AllowedAction Array of String 任务在当前状态下允许的操作列表
注意:此字段可能返回 null,表示取不到有效值。
示例值:["view","modify","configure","view","isolate","resize"]

MigrateDBItem

查询迁移实例列表的实例对象

被如下接口引用:DescribeMigrateDBInstances。

名称 类型 描述
InstanceId String 实例ID
示例值:cdb-9djwowo2
InstanceName String 实例名称
示例值:实例名称
Vip String 实例Vip
示例值:192.168.1.1
Vport Integer 实例Vport
示例值:3306
Usable Integer 是否可以作为迁移对象,1-可以,0-不可以
示例值:1
Hint String 不可以作为迁移对象的原因
示例值:当前实例不可以作为迁移源

MigrateDetailInfo

迁移执行过程信息

被如下接口引用:DescribeMigrationDetail, DescribeMigrationJobs。

名称 类型 描述
StepAll Integer 总步骤数
注意:此字段可能返回 null,表示取不到有效值。
示例值:3
StepNow Integer 当前步骤
注意:此字段可能返回 null,表示取不到有效值。
示例值:3
MasterSlaveDistance Integer 主从差距,MB;只在任务正常,迁移或者同步的最后一步(追Binlog的阶段才有校),如果是非法值,返回-1
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
SecondsBehindMaster Integer 主从差距,秒;只在任务正常,迁移或者同步的最后一步(追Binlog的阶段才有校),如果是非法值,返回-1
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
StepInfo Array of StepDetailInfo 步骤信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:[]

MigrateOption

迁移选项,描述任务如何执行迁移等一系列配置信息

被如下接口引用:DescribeMigrationDetail, ModifyMigrationJob。

名称 类型 必选 描述
DatabaseTable DatabaseTableObject 迁移对象选项,需要告知迁移服务迁移哪些库表对象
注意:此字段可能返回 null,表示取不到有效值。
MigrateType String 迁移类型,full(全量迁移),structure(结构迁移),fullAndIncrement(全量加增量迁移), 默认为fullAndIncrement;注意redis,keewidb产品只支持fullAndIncrement类型。
注意:此字段可能返回 null,表示取不到有效值。
示例值:fullAndIncrement
Consistency ConsistencyOption 数据一致性校验选项, 默认为不开启一致性校验
注意:此字段可能返回 null,表示取不到有效值。
IsMigrateAccount Boolean 是否迁移账号,true(迁移账号),false(不迁移账号)
注意:此字段可能返回 null,表示取不到有效值。
示例值:false
IsOverrideRoot Boolean 是否用源库Root账户覆盖目标库,值包括:false-不覆盖,true-覆盖,选择库表或者结构迁移时应该为false,注意只对旧版迁移有效
注意:此字段可能返回 null,表示取不到有效值。
示例值:false
IsDstReadOnly Boolean 是否在迁移时设置目标库只读(仅对mysql有效),true(设置只读)、false(不设置只读,默认此值)
注意:此字段可能返回 null,表示取不到有效值。
示例值:false
ExtraAttr Array of KeyValuePairOption 其他附加信息,对于特定库可设置额外参数,Redis可定义如下的参数:
["DstWriteMode":normal, 目标库写入模式,可取值clearData(清空目标实例数据)、overwrite(以覆盖写的方式执行任务)、normal(跟正常流程一样,不做额外动作) "IsDstReadOnly":true, 是否在迁移时设置目标库只读,true(设置只读)、false(不设置只读) "ClientOutputBufferHardLimit":512, 从机缓冲区的硬性容量限制(MB) "ClientOutputBufferSoftLimit":512, 从机缓冲区的软性容量限制(MB) "ClientOutputBufferPersistTime":60, 从机缓冲区的软性限制持续时间(秒) "ReplBacklogSize":512, 环形缓冲区容量限制(MB) "ReplTimeout":120, 复制超时时间(秒) "IsExpireKey":"true",过期key自动淘汰]
注意:此字段可能返回 null,表示取不到有效值。
MigrateWay String pgsql迁移分类:logical(逻辑迁移)、physical(物理迁移)
注意:此字段可能返回 null,表示取不到有效值。
示例值:logical

ModifiedSubscribeObject

数据数据订阅的对象,用于修改订阅对象接口。与SubscribeObject结构类似,只是类型和参数名不同。

被如下接口引用:ModifySubscribeObjects。

名称 类型 必选 描述
ObjectsType Integer 订阅对象的类型,枚举值为:0-库,1-表(该值对于mongo任务来说,是集合) 。
注意:mongo只支持全实例、单库或者单集合订阅,因此该字段不要与SubscribeObjectType冲突。如:SubscribeObjectType=4,表示mongo单库订阅,那么该字段应该传0。
注意:此字段可能返回 null,表示取不到有效值。
DatabaseName String 订阅数据库的名称
注意:此字段可能返回 null,表示取不到有效值。
TableNames Array of String 订阅数据库中表(或集合)的名称。如果 ObjectsType 为 1,那么此字段为必填,且不为空;
注意:此字段可能返回 null,表示取不到有效值。

MonitorInfo

kafka消费者组的分区详情

被如下接口引用:DescribeConsumerGroups。

名称 类型 描述
PartitionNo Integer 当前分区的编号,从0开始
示例值:1
ConsumerGroupOffset Integer 当前分区的偏移量
示例值:1111
ConsumerGroupLag Integer 当前分区未消费的数据量
示例值:0
Latency Integer 当前分区的消费延迟(单位为秒)
示例值:1

Objects

同步的数据库对对象描述

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs, ModifySyncJobConfig。

名称 类型 必选 描述
Mode String 同步对象类型 Partial(部分对象)
注意:此字段可能返回 null,表示取不到有效值。
示例值:Partial
Databases Array of Database 同步对象,当 Mode 为 Partial 时,不为空
注意:此字段可能返回 null,表示取不到有效值。
AdvancedObjects Array of String 高级对象类型,如function、procedure。注意:如果要迁移同步高级对象,此配置中应该包含对应的高级对象类型。当需要同步高级对象时,初始化类型必须包含结构初始化类型,即任务的Options.InitType字段值为Structure或Full
注意:此字段可能返回 null,表示取不到有效值。
示例值:["function"]
OnlineDDL OnlineDDL OnlineDDL类型,冗余字段不做配置用途
注意:此字段可能返回 null,表示取不到有效值。

OffsetTimeMap

数据订阅kafka分区中checkpoint信息

被如下接口引用:DescribeOffsetByTime。

名称 类型 描述
PartitionNo Integer kafka分区编号
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
Offset Integer kafka offset
注意:此字段可能返回 null,表示取不到有效值。
示例值:1234565

OnlineDDL

OnlineDDL类型

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs, ModifySyncJobConfig。

名称 类型 必选 描述
Status String 状态
注意:此字段可能返回 null,表示取不到有效值。
示例值:ON

Options

数据同步中的选项

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs。

名称 类型 必选 描述
InitType String 同步初始化选项,Data(全量数据初始化)、Structure(结构初始化)、Full(全量数据且结构初始化,默认)、None(仅增量)
注意:此字段可能返回 null,表示取不到有效值。
示例值:Full
DealOfExistSameTable String 同名表的处理,ReportErrorAfterCheck(前置校验并报错,默认)、ExecuteAfterIgnore(忽略并继续执行)
注意:此字段可能返回 null,表示取不到有效值。
示例值:ReportErrorAfterCheck
ConflictHandleType String 冲突处理选项,ReportError(报错,默认为该值)、Ignore(忽略)、Cover(覆盖)、ConditionCover(条件覆盖)
注意:此字段可能返回 null,表示取不到有效值。
示例值:ReportError
AddAdditionalColumn Boolean 是否添加附加列
注意:此字段可能返回 null,表示取不到有效值。
示例值:false
OpTypes Array of String 所要同步的DML和DDL的选项,Insert(插入操作)、Update(更新操作)、Delete(删除操作)、DDL(结构同步), 不填(不选),PartialDDL(自定义,和DdlOptions一起起作用 )
注意:此字段可能返回 null,表示取不到有效值。
示例值:["Insert","Update","Delete","DDL"]
ConflictHandleOption ConflictHandleOption 冲突处理的详细选项,如条件覆盖中的条件行和条件操作
注意:此字段可能返回 null,表示取不到有效值。
示例值:ConflictHandleOption
DdlOptions Array of DdlOption DDL同步选项,具体描述要同步那些DDL
注意:此字段可能返回 null,表示取不到有效值。
示例值:DdlOption
KafkaOption KafkaOption kafka同步选项
注意:此字段可能返回 null,表示取不到有效值。
示例值:KafkaOption
RateLimitOption RateLimitOption 任务限速信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:RateLimitOption
AutoRetryTimeRangeMinutes Integer 自动重试的时间窗口设置
注意:此字段可能返回 null,表示取不到有效值。
示例值:20
FilterBeginCommit Boolean 同步到kafka链路是否过滤掉begin和commit消息。目前仅mysql2kafka链路支持
注意:此字段可能返回 null,表示取不到有效值。
示例值:false
FilterCheckpoint Boolean 同步到kafka链路是否过滤掉checkpoint消息。目前仅mysql2kafka链路支持
注意:此字段可能返回 null,表示取不到有效值。
示例值:false

PartitionAssignment

数据订阅中kafka消费者组的分区分配情况。该数据是实时查询的,如果需要最新数据,需重新掉接口查询。

被如下接口引用:DescribeConsumerGroups。

名称 类型 描述
ClientId String 消费者的clientId
示例值:ding
PartitionNo Array of Integer 该消费者正在消费的分区
注意:此字段可能返回 null,表示取不到有效值。
示例值:[0,1]

PipelineInfo

mongo输出聚合设置。输出默认 Change Event

被如下接口引用:ConfigureSubscribeJob, DescribeSubscribeDetail, ModifySubscribeObjects。

名称 类型 必选 描述
AggOp String 聚合运算符:$addFields、$match、$project、$replaceRoot、$redact、$replaceWith、$set、$unset。其中 $replaceWith、$set、$unset 只有当订阅实例是4.2及以上版本可选。
注意:此字段可能返回 null,表示取不到有效值。
示例值:$addFields
AggCmd String 聚合表达式。必须是json格式
注意:此字段可能返回 null,表示取不到有效值。
示例值:{"a":""}

ProcessProgress

任务步骤信息

被如下接口引用:DescribeCompareTasks, DescribeMigrationDetail。

名称 类型 描述
Status String 步骤的状态, 包括:notStarted(未开始)、running(运行中)、success(成功)、failed(失败)等
注意:此字段可能返回 null,表示取不到有效值。
示例值:success
Percent Integer 进度信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
StepAll Integer 总的步骤数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
StepNow Integer 当前进行的步骤
注意:此字段可能返回 null,表示取不到有效值。
示例值:3
Message String 当前步骤输出提示信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:ok
Steps Array of StepDetailInfo 步骤信息
注意:此字段可能返回 null,表示取不到有效值。

ProcessStepTip

错误信息及告警信息对象

被如下接口引用:DescribeCompareTasks, DescribeMigrationDetail, DescribeMigrationJobs。

名称 类型 描述
Message String 提示信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:execute fail: Error 1146: Table 'tencentdb.eg_dts-4lcse9uh' doesn't exist
Solution String 解决方案
注意:此字段可能返回 null,表示取不到有效值。
示例值:1. 请到目标库执行'show create table xxx',确认该表是否存在;如果不存在,请在目标库中手动建表,然后重试任务。
HelpDoc String 文档提示
注意:此字段可能返回 null,表示取不到有效值。
示例值:库表不存在

RateLimitOption

迁移和同步任务限速的详细信息

被如下接口引用:ConfigureSyncJob, DescribeMigrationDetail, DescribeSyncJobs。

名称 类型 必选 描述
CurrentDumpThread Integer 当前生效的全量导出线程数,配置任务时可调整该字段值,注意:如果不设置或设置为0则表示保持当前值,最大值为16
注意:此字段可能返回 null,表示取不到有效值。
示例值:8
DefaultDumpThread Integer 默认的全量导出线程数,该字段仅在出参有意义
注意:此字段可能返回 null,表示取不到有效值。
示例值:8
CurrentDumpRps Integer 当前生效的全量导出Rps,配置任务时可调整该字段值,注意:如果不设置或设置为0则表示保持当前值,最大值为50000000
注意:此字段可能返回 null,表示取不到有效值。
示例值:400000
DefaultDumpRps Integer 默认的全量导出Rps,该字段仅在出参有意义
注意:此字段可能返回 null,表示取不到有效值。
示例值:400000
CurrentLoadThread Integer 当前生效的全量导入线程数,配置任务时可调整该字段值,注意:如果不设置或设置为0则表示保持当前值,最大值为16
注意:此字段可能返回 null,表示取不到有效值。
示例值:8
DefaultLoadThread Integer 默认的全量导入线程数,该字段仅在出参有意义
注意:此字段可能返回 null,表示取不到有效值。
示例值:8
CurrentLoadRps Integer 当前生效的全量导入Rps,配置任务时可调整该字段值,注意:如果不设置或设置为0则表示保持当前值,最大值为50000000
注意:此字段可能返回 null,表示取不到有效值。
示例值:400000
DefaultLoadRps Integer 默认的全量导入Rps,该字段仅在出参有意义
注意:此字段可能返回 null,表示取不到有效值。
示例值:400000
CurrentSinkerThread Integer 当前生效的增量导入线程数,配置任务时可调整该字段值,注意:如果不设置或设置为0则表示保持当前值,最大值为128
注意:此字段可能返回 null,表示取不到有效值。
示例值:32
DefaultSinkerThread Integer 默认的增量导入线程数,该字段仅在出参有意义
注意:此字段可能返回 null,表示取不到有效值。
示例值:32
HasUserSetRateLimit String enum:"no"/"yes"、no表示用户未设置过限速、yes表示设置过限速,该字段仅在出参有意义
注意:此字段可能返回 null,表示取不到有效值。
示例值:no

RoleItem

角色对象,postgresql独有参数

被如下接口引用:DescribeMigrationDetail, ModifyMigrationJob。

名称 类型 必选 描述
RoleName String 角色名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:r1
NewRoleName String 迁移后的角色名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:r1_new

RowsCountDifference

mongodb行校验不一致详细信息

被如下接口引用:DescribeCompareReport。

名称 类型 描述
Db String 数据库名
注意:此字段可能返回 null,表示取不到有效值。
示例值:user
Table String 集合
注意:此字段可能返回 null,表示取不到有效值。
示例值:user_core
SrcCount Integer 源端行数
注意:此字段可能返回 null,表示取不到有效值。
示例值:100
DstCount Integer 目标端行数
注意:此字段可能返回 null,表示取不到有效值。
示例值:105

SkippedDetail

跳过校验的表详情

被如下接口引用:DescribeCompareReport。

名称 类型 描述
TotalCount Integer 跳过的表数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Items Array of SkippedItem 跳过校验的表详情
注意:此字段可能返回 null,表示取不到有效值。

SkippedItem

跳过校验的表详情

被如下接口引用:DescribeCompareReport。

名称 类型 描述
Db String 数据库名
注意:此字段可能返回 null,表示取不到有效值。
示例值:db1
Table String 表名
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1
Reason String 未发起检查的原因
注意:此字段可能返回 null,表示取不到有效值。
示例值:engine not support, only support MyISAM or InnoDB

StepDetailInfo

步骤信息

被如下接口引用:DescribeCompareTasks, DescribeMigrationDetail, DescribeMigrationJobs。

名称 类型 描述
StepNo Integer 步骤序列
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
StepName String 步骤展现名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:源库导出
StepId String 步骤英文标识
注意:此字段可能返回 null,表示取不到有效值。
示例值:dumper
Status String 步骤状态:success(成功)、failed(失败)、running(执行中)、notStarted(未执行)、默认为notStarted
注意:此字段可能返回 null,表示取不到有效值。
示例值:running
StartTime String 当前步骤开始的时间,格式为"yyyy-mm-dd hh:mm:ss",该字段不存在或者为空是无意义 注意:此字段可能返回 null,表示取不到有效值。
注意:此字段可能返回 null,表示取不到有效值。
示例值:2022-07-11 17:22:43
StepMessage String 步骤错误信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:i/o timeout
Percent Integer 执行进度
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
Errors Array of ProcessStepTip 错误信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:[]
Warnings Array of ProcessStepTip 告警提示
注意:此字段可能返回 null,表示取不到有效值。
示例值:[]

StepInfo

单个步骤的详细信息

被如下接口引用:DescribeCheckSyncJobResult, DescribeModifyCheckSyncJobResult, DescribeSyncJobs。

名称 类型 必选 描述
StepNo Integer 步骤编号
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
StepName String 步骤名
注意:此字段可能返回 null,表示取不到有效值。
示例值:连接DB检查
StepId String 步骤标号
注意:此字段可能返回 null,表示取不到有效值。
示例值:ConnectDBCheck
Status String 当前步骤状态,可能返回有 notStarted(未开始)、running(校验中)、failed(校验任务失败)、finished(完成)、skipped(跳过)、paused(暂停)
注意:此字段可能返回 null,表示取不到有效值。
示例值:finished
StartTime String 步骤开始时间,可能为空
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-19 15:54:18
Errors Array of StepTip 错误信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:[]
Warnings Array of StepTip 警告信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:[]
Progress Integer 当前步骤进度,范围为[0-100],若为-1表示当前步骤不支持查看进度
注意:此字段可能返回 null,表示取不到有效值。
示例值:100

StepTip

当前步骤错误信息或者警告信息

被如下接口引用:DescribeCheckSyncJobResult, DescribeModifyCheckSyncJobResult。

名称 类型 必选 描述
Code String 错误码
注意:此字段可能返回 null,表示取不到有效值。
示例值:Error: OptimizeCheck
Message String 错误信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:修改目标库session级别explicit_defaults_for_timestamp参数为ON失败,错误信息详情
Solution String 解决方式
注意:此字段可能返回 null,表示取不到有效值。
示例值:尝试以下解决方案:1.xxx,2.xxx
HelpDoc String 帮助文档
注意:此字段可能返回 null,表示取不到有效值。
示例值:周边检查: cloud.tencent.com/document/product/571/58690
SkipInfo String 当前步骤跳过信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:如果目标库explicit_defaults_for_timestamp参数不为ON,timestamp列的隐式转换规则可能会导致源库和目标库结构不一致

SubsErr

订阅报错信息

被如下接口引用:DescribeSubscribeDetail, DescribeSubscribeJobs。

名称 类型 描述
Message String 报错信息
示例值:invalid connection

SubscribeCheckStepInfo

订阅校验任务的各步骤信息。

被如下接口引用:DescribeSubscribeCheckJob。

名称 类型 描述
StepName String 步骤名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:连接DB检查
StepId String 步骤Id
注意:此字段可能返回 null,表示取不到有效值。
示例值:ConnectDBCheck
StepNo Integer 步骤编号,从 1 开始
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Status String 当前步骤状态,可能值为 notStarted,running,finished,failed
注意:此字段可能返回 null,表示取不到有效值。
示例值:running
Percent Integer 当前步骤进度
注意:此字段可能返回 null,表示取不到有效值。
示例值:100
Errors Array of SubscribeCheckStepTip 错误提示
注意:此字段可能返回 null,表示取不到有效值。
Warnings Array of SubscribeCheckStepTip 告警提示
注意:此字段可能返回 null,表示取不到有效值。

SubscribeCheckStepTip

订阅校验任务的提示信息

被如下接口引用:DescribeSubscribeCheckJob。

名称 类型 描述
Message String 错误或告警的详细信息
注意:此字段可能返回 null,表示取不到有效值。
HelpDoc String 帮助文档
注意:此字段可能返回 null,表示取不到有效值。

SubscribeInfo

订阅实例信息

被如下接口引用:DescribeSubscribeJobs。

名称 类型 描述
SubscribeId String 数据订阅的实例ID
示例值:subs-9jyki7hniw
SubscribeName String 数据订阅实例的名称
示例值:test
Topic String 订阅实例发送数据的kafka topic
注意:此字段可能返回 null,表示取不到有效值。
示例值:topic-subs-l4d3a7izai-cmgo-24ifcx43
Product String 订阅实例的类型,目前支持 cynosdbmysql,mariadb,mongodb,mysql,percona,tdpg,tdsqlpercona(tdsqlmysql)
示例值:mysql
InstanceId String 订阅的数据库实例ID(如果订阅的是云数据库)如果实例不是腾讯云上的,此值为空。
注意:此字段可能返回 null,表示取不到有效值。
示例值:cdb-kdxona7h
InstanceStatus String 云数据库状态:running 运行中,isolated 已隔离,offline 已下线。如果不是云上,此值为空
注意:此字段可能返回 null,表示取不到有效值。
示例值:running
Status String 数据订阅生命周期状态,可能的值为:正常 normal, 隔离中 isolating, 已隔离 isolated, 下线中 offlining, 按量转包年包月中 post2PrePayIng
示例值:normal
SubsStatus String 数据订阅状态,可能的值为:未启动 notStarted, 校验中 checking, 校验不通过 checkNotPass, 校验通过 checkPass, 启动中 starting, 运行中 running, 异常出错 error
示例值:running
ModifyTime String 上次修改时间,时间格式如:Y-m-d h:m:s
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-05-15 21:29:05
CreateTime String 创建时间,时间格式如:Y-m-d h:m:s
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-05-15 21:29:05
IsolateTime String 隔离时间,时间格式如:Y-m-d h:m:s。默认:0000-00-00 00:00:00
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-05-15 21:29:05
ExpireTime String 包年包月任务的到期时间,时间格式如:Y-m-d h:m:s。默认:0000-00-00 00:00:00
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-05-15 21:29:05
OfflineTime String 下线时间,时间格式如:Y-m-d h:m:s。默认:0000-00-00 00:00:00
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-05-15 21:29:05
PayType Integer 计费方式,0 - 包年包月,1 - 按量计费
示例值:0
AutoRenewFlag Integer 自动续费标识。只有当 PayType=0,该值才有意义。枚举值:0-不自动续费,1-自动续费
示例值:1
Region String 数据订阅实例所属地域
示例值:ap-guangzhou
AccessType String 接入方式。枚举值:extranet(公网) vpncloud(vpn接入) dcg(专线接入) ccn(云联网) cdb(云数据库) cvm(云主机自建) intranet(自研上云) vpc(私有网络vpc)
注意:此字段可能返回 null,表示取不到有效值。
Endpoints Array of EndpointItem 数据库节点信息
注意:此字段可能返回 null,表示取不到有效值。
SubscribeVersion String 数据订阅版本, 当前只支持 kafka 版本。
注意:此字段可能返回 null,表示取不到有效值。
示例值:kafka
Tags Array of TagItem 标签
注意:此字段可能返回 null,表示取不到有效值。
Errors Array of SubsErr 任务报错信息,如果有的话。
注意:此字段可能返回 null,表示取不到有效值。

SubscribeKafkaConfig

订阅的kafka分区数和分区规则。mariadb,percona,tdsqlmysql,tdpg不支持自定义分区,所以DistributeRules和DefaultRuleType可以不填,但是NumberOfPartitions是必填。

被如下接口引用:ConfigureSubscribeJob, DescribeSubscribeDetail。

名称 类型 必选 描述
NumberOfPartitions Integer kafka分区数量,枚举值为1,4,8
注意:此字段可能返回 null,表示取不到有效值。
示例值:8
DistributeRules Array of DistributeRule 分区规则。当NumberOfPartitions > 1时,该项必填。
注意:此字段可能返回 null,表示取不到有效值。
DefaultRuleType String 默认分区策略。当NumberOfPartitions > 1时,该项必填。不满足DistributeRules中正则表达式的数据,将按照默认分区策略计算分区。
非mongo产品的枚举值为: table-按表名分区,pk-按表名+主键分区。mongo的枚举值为:collection-按集合名分区。
该字段与DistributeRules搭配使用,如果配置了该字段,视为配置了一条DistributeRules。
注意:此字段可能返回 null,表示取不到有效值。
示例值:table

SubscribeObject

订阅的数据库表信息,用于配置和查询订阅任务接口。

被如下接口引用:ConfigureSubscribeJob, DescribeSubscribeDetail。

名称 类型 必选 描述
ObjectType String 订阅数据的类型,枚举值:database-数据库,table-数据库的表(如果 DatabaseType 为 mongodb,则表示集合)
注意:此字段可能返回 null,表示取不到有效值。
示例值:table
Database String 订阅的数据库名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:databaseName
Tables Array of String 订阅数据库中表的名称。如果 DatabaseType 为 mongodb,填集合名。mongodb只支持订阅单库或者单集合。
注意:此字段可能返回 null,表示取不到有效值。

SyncDBEndpointInfos

数据同步配置多节点数据库的节点信息。多节点数据库,如tdsqlmysql使用该结构;单节点数据库,如mysql使用Endpoint。

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs。

名称 类型 必选 描述
Region String 数据库所在地域
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-guangzhou
AccessType String 实例网络接入类型,如:extranet(外网)、ipv6(公网ipv6)、cvm(云主机自建)、dcg(专线接入)、vpncloud(vpn接入的实例)、cdb(云数据库)、ccn(云联网)、intranet(自研上云)、vpc(私有网络)等,注意具体可选值依赖当前链路
注意:此字段可能返回 null,表示取不到有效值。
示例值:cdb
DatabaseType String 实例数据库类型,如:mysql,redis,mongodb,postgresql,mariadb,percona 等
注意:此字段可能返回 null,表示取不到有效值。
示例值:tdsqlmysql
Info Array of Endpoint 数据库信息。注意:如果数据库类型为tdsqlmysql,此处Endpoint数组的顺序应满足规则:proxy节点放在set节点之前。如果SrcConnectType选择proxy接入则只需要填写proxy节点即可。如果选择set接入,数组中第一个set节点必须是shardkey范围起始为0的分片
注意:此字段可能返回 null,表示取不到有效值。

SyncDetailInfo

同步任务的步骤信息

被如下接口引用:DescribeSyncJobs。

名称 类型 描述
StepAll Integer 总步骤数
注意:此字段可能返回 null,表示取不到有效值。
示例值:4
StepNow Integer 当前步骤
注意:此字段可能返回 null,表示取不到有效值。
示例值:4
Progress Integer 总体进度
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
CurrentStepProgress Integer 当前步骤进度,范围为[0-100],若为-1表示当前步骤不支持查看进度
注意:此字段可能返回 null,表示取不到有效值。
示例值:50
MasterSlaveDistance Integer 同步两端数据量差距
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
SecondsBehindMaster Integer 同步两端时间差距
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
Message String 总体描述信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:
StepInfos Array of StepInfo 详细步骤信息
注意:此字段可能返回 null,表示取不到有效值。
CauseOfCompareDisable String 不能发起一致性校验的原因
注意:此字段可能返回 null,表示取不到有效值。
示例值:当前任务开启了DML过滤
ErrInfo ErrInfo 任务的错误和解决方案信息
注意:此字段可能返回 null,表示取不到有效值。

SyncJobInfo

同步任务信息

被如下接口引用:DescribeSyncJobs。

名称 类型 描述
JobId String 同步任务id,如:sync-btso140
注意:此字段可能返回 null,表示取不到有效值。
示例值:sync-btso140
JobName String 同步任务名
注意:此字段可能返回 null,表示取不到有效值。
示例值:test
PayMode String 付款方式,PostPay(按量付费)、PrePay(包年包月)
注意:此字段可能返回 null,表示取不到有效值。
示例值:PostPay
RunMode String 运行模式,Immediate(表示立即运行,默认为此项值)、Timed(表示定时运行)
注意:此字段可能返回 null,表示取不到有效值。
示例值:Immediate
ExpectRunTime String 期待运行时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-08 16:24:32
AllActions Array of String 支持的所有操作
注意:此字段可能返回 null,表示取不到有效值。
示例值:["view","configure","check","start","stop","resume","pause","continue","limitRate","resize","isolate","offline","recover","postPay2prePay","configureOptObj","checkOptObj","startOptObj","createCmpTask"]
Actions Array of String 当前状态能进行的操作
注意:此字段可能返回 null,表示取不到有效值。
示例值:["pause","stop","limitRate","view","resize","isolate","postPay2prePay","configureOptObj"]
Options Options 同步选项
注意:此字段可能返回 null,表示取不到有效值。
Objects Objects 同步库表对象
注意:此字段可能返回 null,表示取不到有效值。
Specification String 任务规格
注意:此字段可能返回 null,表示取不到有效值。
示例值:large
ExpireTime String 过期时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-08 16:24:32
SrcRegion String 源端地域,如:ap-guangzhou等
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-guangzhou
SrcDatabaseType String 源端数据库类型,mysql,cynosdbmysql,tdapg,tdpg,tdsqlmysql等
注意:此字段可能返回 null,表示取不到有效值。
示例值:mysql
SrcAccessType String 源端接入类型,cdb(云数据库)、cvm(云主机自建)、vpc(私有网络)、extranet(外网)、vpncloud(vpn接入)、dcg(专线接入)、ccn(云联网)、intranet(自研上云)
注意:此字段可能返回 null,表示取不到有效值。
示例值:cdb
SrcInfo Endpoint 源端信息,单节点数据库使用
注意:此字段可能返回 null,表示取不到有效值。
SrcNodeType String 枚举值:cluster、single。源库为单节点数据库使用single,多节点使用cluster
注意:此字段可能返回 null,表示取不到有效值。
示例值:cluster
SrcInfos SyncDBEndpointInfos 源端信息,多节点数据库使用
注意:此字段可能返回 null,表示取不到有效值。
DstRegion String 目标端地域,如:ap-guangzhou等
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-guangzhou
DstDatabaseType String 目标端数据库类型,mysql,cynosdbmysql,tdapg,tdpg,tdsqlmysql等
注意:此字段可能返回 null,表示取不到有效值。
示例值:mysql
DstAccessType String 目标端接入类型,cdb(云数据库)、cvm(云主机自建)、vpc(私有网络)、extranet(外网)、vpncloud(vpn接入)、dcg(专线接入)、ccn(云联网)、intranet(自研上云)
注意:此字段可能返回 null,表示取不到有效值。
示例值:cdb
DstInfo Endpoint 目标端信息,单节点数据库使用
注意:此字段可能返回 null,表示取不到有效值。
DstNodeType String 枚举值:cluster、single。目标库为单节点数据库使用single,多节点使用cluster
注意:此字段可能返回 null,表示取不到有效值。
示例值:cluster
DstInfos SyncDBEndpointInfos 目标端信息,多节点数据库使用
注意:此字段可能返回 null,表示取不到有效值。
CreateTime String 创建时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-08 16:24:32
StartTime String 开始时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-08 16:24:32
Status String 任务状态,UnInitialized(未初始化)、Initialized(已初始化)、Checking(校验中)、CheckPass(校验通过)、CheckNotPass(校验不通过)、ReadyRunning(准备运行)、Running(运行中)、Pausing(暂停中)、Paused(已暂停)、Stopping(停止中)、Stopped(已结束)、ResumableErr(任务错误)、Resuming(恢复中)、Failed(失败)、Released(已释放)、Resetting(重置中)、Unknown(未知)
注意:此字段可能返回 null,表示取不到有效值。
示例值:CheckPass
EndTime String 结束时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-08 16:24:32
Tags Array of TagItem 标签相关信息
注意:此字段可能返回 null,表示取不到有效值。
Detail SyncDetailInfo 同步任务运行步骤信息
注意:此字段可能返回 null,表示取不到有效值。
TradeStatus String 用于计费的状态,可能取值有:Normal(正常状态)、Resizing(变配中)、Renewing(续费中)、Isolating(隔离中)、Isolated(已隔离)、Offlining(下线中)、Offlined(已下线)、NotBilled(未计费)、Recovering(解隔离)、PostPay2Prepaying(按量计费转包年包月中)、PrePay2Postpaying(包年包月转按量计费中)
注意:此字段可能返回 null,表示取不到有效值。
示例值:Normal
InstanceClass String 同步链路规格,如micro,small,medium,large
注意:此字段可能返回 null,表示取不到有效值。
示例值:medium
AutoRenew Integer 自动续费标识,当PayMode值为PrePay则此项配置有意义,取值为:1(表示自动续费)、0(不自动续费)
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
OfflineTime String 下线时间,格式为 yyyy-mm-dd hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-08 16:24:32
AutoRetryTimeRangeMinutes Integer 自动重试时间段设置
注意:此字段可能返回 null,表示取不到有效值。
示例值:5
DumperResumeCtrl String 全量导出可重入标识:enum::"yes"/"no"。yes表示当前任务可重入、no表示当前任务处于全量导出且不可重入阶段;如果在该值为no时重启任务导出流程不支持断点续传
注意:此字段可能返回 null,表示取不到有效值。
示例值:yes

Table

数据同步库表信息描述

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs, ModifySyncJobConfig。

名称 类型 必选 描述
TableName String 表名
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1
NewTableName String 新表名
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1_new
FilterCondition String 过滤条件
注意:此字段可能返回 null,表示取不到有效值。
示例值:where id > 100
ColumnMode String 是否同步表中所有列,All:当前表下的所有列,Partial(ModifySyncJobConfig接口里的对应字段ColumnMode暂不支持Partial):当前表下的部分列,通过填充Columns字段详细表信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:All
Columns Array of Column 同步的列信息,当ColumnMode为Partial时,必填
注意:此字段可能返回 null,表示取不到有效值。
TmpTables Array of String 同步临时表,注意此配置与NewTableName互斥,只能使用其中一种。当配置的同步对象为表级别且TableEditMode为pt时此项有意义,针对pt-osc等工具在同步过程中产生的临时表进行同步,需要提前将可能的临时表配置在这里,否则不会同步任何临时表。示例,如要对t1进行pt-osc操作,此项配置应该为["_t1_new","_t1_old"];如要对t1进行gh-ost操作,此项配置应该为["_t1_ghc","_t1_gho","_t1_del"],pt-osc与gh-ost产生的临时表可同时配置。
注意:此字段可能返回 null,表示取不到有效值。
示例值:["t1old",t1new"]
TableEditMode String 编辑表类型,rename(表映射),pt(同步附加表)
注意:此字段可能返回 null,表示取不到有效值。
示例值:pt

TableItem

表对象集合,当 TableMode 为 partial 时,此项需要填写

被如下接口引用:DescribeMigrationDetail, ModifyMigrationJob。

名称 类型 必选 描述
TableName String 迁移的表名,大小写敏感
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1
NewTableName String 迁移后的表名,当TableEditMode为rename时此项必填,注意此配置与TmpTables互斥,只能使用其中一种
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1_new
TmpTables Array of String 迁移临时表,注意此配置与NewTableName互斥,只能使用其中一种。当配置的同步对象为表级别且TableEditMode为pt时此项有意义,针对pt-osc等工具在迁移过程中产生的临时表进行同步,需要提前将可能的临时表配置在这里,否则不会同步任何临时表。示例,如要对t1进行pt-osc操作,此项配置应该为["_t1_new","_t1_old"];如要对t1进行gh-ost操作,此项配置应该为["_t1_ghc","_t1_gho","_t1_del"],pt-osc与gh-ost产生的临时表可同时配置。
注意:此字段可能返回 null,表示取不到有效值。
示例值:["t1old",t1new"]
TableEditMode String 编辑表类型,rename(表映射),pt(同步附加表)
注意:此字段可能返回 null,表示取不到有效值。
示例值:rename

TagFilter

标签过滤

被如下接口引用:DescribeMigrationJobs, DescribeSubscribeJobs, DescribeSyncJobs。

名称 类型 必选 描述
TagKey String 标签键值
示例值:key
TagValue Array of String 标签值
示例值:[value1, value2]

TagItem

标签

被如下接口引用:CreateMigrationService, CreateSubscribe, CreateSyncJob, DescribeMigrationDetail, DescribeMigrationJobs, DescribeSubscribeDetail, DescribeSubscribeJobs, DescribeSyncJobs, ModifyMigrationJob。

名称 类型 必选 描述
TagKey String 标签键
注意:此字段可能返回 null,表示取不到有效值。
示例值:key
TagValue String 标签值
注意:此字段可能返回 null,表示取不到有效值。
示例值:value

TopicRule

单topic和自定义topic的描述。投递到单topic时,该数组的最后一项会被视为默认分区策略,所有未匹配到的数据都会按该策略投递,默认策略只支持 投递至partition0、按表名、表名+主键三种。

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs。

名称 类型 必选 描述
TopicName String topic名。单topic时,所有的TopicName必须相同
示例值:test
PartitionType String topic分区策略,自定义topic时支持:Random(随机投递),集中投递到单Topic时支持:AllInPartitionZero(全部投递至partition0)、PartitionByTable(按表名分区)、PartitionByTableAndKey(按表名加主键分区)、PartitionByCols(按列分区)
示例值:Random(自定义topic时使用),AllInPartitionZero(全部投递至partition0), PartitionByTable(按表名分区),PartitionByTableAndKey(按表名加主键分区), PartitionByCols(按列名分区)
DbMatchMode String 库名匹配规则,如Regular(正则匹配), Default(不符合匹配规则的剩余库),数组中最后一项必须为‘Default’
示例值:Regular(正则匹配), Default(不符合匹配规则的剩余库)
DbName String 库名,DbMatchMode=Regular时生效
示例值:db1
TableMatchMode String 表名匹配规则,如Regular(正则匹配), Default(不符合匹配规则的剩余表),数组中最后一项必须为‘Default’
示例值:Regular(正则匹配), Default(不符合匹配规则的剩余表)
TableName String 表名,仅TableMatchMode=Regular时生效
示例值:tb1
Columns Array of String 按列分区时需要选择配置列名,可以选择多列
注意:此字段可能返回 null,表示取不到有效值。

TradeInfo

计费状态信息

被如下接口引用:DescribeMigrationDetail, DescribeMigrationJobs。

名称 类型 描述
DealName String 交易订单号
注意:此字段可能返回 null,表示取不到有效值。
示例值:20220711715001047929481
LastDealName String 上一次交易订单号
注意:此字段可能返回 null,表示取不到有效值。
InstanceClass String 实例规格,包括:micro、small、medium、large、xlarge、2xlarge等
注意:此字段可能返回 null,表示取不到有效值。
示例值:xlarge
TradeStatus String 计费任务状态, normal(计费或待计费)、resizing(变配中)、reversing(冲正中,比较短暂的状态)、isolating(隔离中,比较短暂的状态)、isolated(已隔离)、offlining(下线中)、offlined(已下线)、notBilled(未计费)
注意:此字段可能返回 null,表示取不到有效值。
示例值:normal
ExpireTime String 到期时间,格式为"yyyy-mm-dd hh:mm:ss"
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-12 15:54:18
OfflineTime String 下线时间,格式为"yyyy-mm-dd hh:mm:ss"
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-19 15:54:18
IsolateTime String 隔离时间,格式为"yyyy-mm-dd hh:mm:ss"
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-12-11 15:54:18
OfflineReason String 下线原因
注意:此字段可能返回 null,表示取不到有效值。
示例值:user_offline
IsolateReason String 隔离原因
注意:此字段可能返回 null,表示取不到有效值。
示例值:user_isolate
PayType String 付费类型,包括:postpay(后付费)、prepay(预付费)
注意:此字段可能返回 null,表示取不到有效值。
示例值:postpay
BillingType String 任务计费类型,包括:billing(计费)、notBilling(不计费)、 promotions(促销活动中)
注意:此字段可能返回 null,表示取不到有效值。
示例值:billing

View

数据同步view的描述

被如下接口引用:ConfigureSyncJob, DescribeSyncJobs, ModifySyncJobConfig。

名称 类型 必选 描述
ViewName String view名
注意:此字段可能返回 null,表示取不到有效值。
示例值:v1
NewViewName String 预留字段、目前暂时不支持view的重命名
注意:此字段可能返回 null,表示取不到有效值。
示例值:v1_new

ViewItem

视图对象

被如下接口引用:DescribeMigrationDetail, ModifyMigrationJob。

名称 类型 必选 描述
ViewName String 视图名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1_view
NewViewName String 迁移后的视图名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:t1_view_new