You need to enable JavaScript to run this app.
Database Transmission Service

Database Transmission Service

Copy page
Download PDF
Data transmission
DescribeTransmissionTaskInfo
Copy page
Download PDF
DescribeTransmissionTaskInfo
Call the DescribeTransmissionTaskInfo API to view the transmission task details.​
Request type​
Synchronous request.​
Precautions​
PG2PGRowCompareSettings​
Request parameters​
​
Name​
Type​
Is it required?​
Example​
Description​
TaskId​
String​
No​
4ddec6d036384248a25862fb********​
Task ID.​
tip​
You can call the DescribeTransmissionTasks API to query the task ID.​
​
Response parameter​
​
Name​
Type​
Example​
Description​
TaskInfo​
Object of TaskInfo​
{​
"ChargeDetail":{​
"ChargeStatus":"Init",​
"ChargeType":"PostPaid",​
"OrderNo":""​
},​
"CreateTime":1661242976288,​
"DestConfig":{​
"DataSourceId":"322",​
"EndpointType":"Volc_Kafka",​
"VolcKafkaSettings":{​
"AuthType":"PLAIN",​
"InstanceId":"kafka-cnngfsm7glfm****",​
"InstanceName":"",​
"Password":"",​
"RegionSettings":{​
"Region":""​
},​
"Topic":"hua",​
"Username":"kakatest"​
}​
},​
"EnableCloudMonitor":true,​
"EndTime":0,​
"ProjectName":"default",​
"SolutionSettings":{​
"PG2KafkaSettings":{​
"ErrorBehaviorSettings":{​
"MaxRetrySeconds":7200​
},​
"FullTransmissionSettings":{​
"EnableFull":false​
},​
"IncrTransmissionSettings":{​
"EnableIncr":true,​
"Statements":[​
"StmtDMLInsert",​
"StmtDMLUpdate",​
"StmtDMLDelete",​
"StmtDDLAll"​
]​
},​
"MetaTransmissionSettings":{​
"EnableMeta":false​
},​
"ObjectMappings":[​
{​
"DestObjName":"public",​
"MappingList":[​
{​
"DestObjName":"",​
"ObjectType":"Table",​
"SrcObjName":""​
}​
],​
"ObjectType":"Database",​
"SrcObjName":"public"​
}​
],​
"SubscriptionSettings":{​
"PartitionPolicy":"P0",​
"Protocol":"Volc",​
"VPCId":"vpc-bp1opxu1zkhn00gz****",​
"VPCSubnetId":""​
}​
},​
"SolutionType":"PG2Kafka"​
},​
"SrcConfig":{​
"DataSourceId":"321",​
"EndpointType":"Volc_PostgreSQL",​
"VolcPostgreSQLSettings":{​
"DBInstanceId":"postgres-338f4f3a****",​
"DBInstanceName":"",​
"DBName":"testzaizai",​
"Password":"",​
"RegionSettings":{​
"Region":"cn-beijing"​
},​
"Username":"testzaizai"​
}​
},​
"StartTime":1661242976288,​
"TaskId":"c37008625ddd44019ee85b84fb****",​
"TaskName":"test****zaizai",​
"TaskStatus":"Init",​
"TaskSubType":"Default",​
"TaskType":"DataSubscription",​
"TenantId":"2100157781",​
"TrafficSpec":"Compact"​
}​
json​
Task details. For details, refer to TaskInfo.​
​
TaskInfo​
​
Name​
Type​
Example​
Description​
TaskId​
String​
6f2fd63c0ea947b280877f5d2a*******​
Task ID.​
TaskName​
String​
test****​
Task name.​
ParentTaskID​
String​
4f85ae2481a643d99c0f45444******​
Primary task ID.​
tip​
  • When bidirectional synchronization is enabled, the value of this parameter is the ID of the forward synchronization task corresponding to the reverse synchronization task.​
  • When querying data verification tasks and bidirectional synchronization tasks, it indicates the ID of the primary task.
ParentTaskName​
String​
diff​
Primary task name.​
tip​
  • When bidirectional synchronization is enabled, the value of this parameter is the name of the forward synchronization task corresponding to the reverse synchronization task.​
  • When querying data verification tasks and bidirectional synchronization tasks, it indicates the name of the primary task.
TenantId​
String​
21000*****​
Account ID.​
TaskStatus​
String​
Failed​
Task status. The valid values are:​
  • Cancelled: Indicates that the task is cancelled.​
  • Failed: Indicates that the task failed.​
  • Running: Indicates that the task is in progress.​
  • Pause: Indicates that the task is paused.​
  • Init: Indicates that the task is to be started.​
  • Terminating: Indicates that the task is terminating.​
  • Success: Indicates that the task was successful.​
TaskType​
String​
DataSubscription​
Task type. The values are as follows:​
  • DataMigration: Indicates a data migration task.​
  • DataSubscription: Indicates a data subscription task.​
  • DataSynchronization: Indicates a data synchronization task.​
  • DataValidation: Indicates a data verification task.​
SrcConfig​
Object of DataSource​
​
{​
"Category": "MySQL",​
"CreateTime": 1767700785480,​
"DataSourceId": "200850054678025****",​
"EndpointType": "Volc_veDB_MySQL",​
"ModifyTime": 1767700803345,​
"VolcveDBMySQLSettings": {​
"DBInstanceId": "vedbm-arjlc5di****",​
"DBInstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "root"​
}​
}​
​
Source information.​
DestConfig​
Object of DataSource​
​
{​
"Category": "MySQL",​
"CreateTime": 1767700785480,​
"DataSourceId": "200850054678025****",​
"EndpointType": "Volc_veDB_MySQL",​
"ModifyTime": 1767700803345,​
"VolcveDBMySQLSettings": {​
"DBInstanceId": "vedbm-arjlc5di****",​
"DBInstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "root"​
}​
}​
​
Destination information.​
SolutionSettings​
Object of SolutionSettings​
​
{​
"MySQL2MySQLSettings": {​
"EnableFullIncr": true​
},​
"SolutionType": "MySQL2MySQL"​
}​
​
The configuration information of the migration, subscription, synchronization, or verification task object.​
ChargeDetail​
Object of ChargeDetailObject​
​
{​
"ChargeEndTime": 7258089600000,​
"ChargeStartTime": 1767700647000,​
"ChargeStatus": "Normal",​
"ChargeType": "PostPaid",​
"OrderNo": ""​
}​
​
Billing information.​
ChargeConfig​
Object of ChargeConfig​
​
{​
"ChargeType": "PostPaid",​
"DestRegion": "cn-beijing",​
"DestType": "Volc_veDB_MySQL",​
"EnableV2": true,​
"IsBidirectional": false,​
"SrcRegion": "cn-beijing",​
"SrcType": "Volc_veDB_MySQL",​
"TaskType": "DataMigration",​
"TrafficSpec": "Standard"​
}​
​
Billing Configuration.​
TrafficSpec​
String​
Compact​
Task link specifications. support Compact, Medium, and Standard values. For details about the link specification, refer to Product specification.​
ProgressSummary​
Object of ProgressSummary​
​
{​
"Infos": [​
{​
"CompletePercentage": 100,​
"ErrorInfo": "",​
"NameCN": "结构迁移",​
"ProgressType": "Meta",​
"Status": "Done"​
},​
{​
"CompletePercentage": 100,​
"NameCN": "全量迁移",​
"ProgressType": "Full",​
"Status": "Doing"​
},​
{​
"Delay": 0,​
"NameCN": "增量迁移",​
"ProgressType": "Incr",​
"Status": "Doing"​
},​
{​
"CompletePercentage": 0,​
"ErrorInfo": "",​
"NameCN": "后置结构迁移",​
"ProgressType": "PostMeta",​
"Status": "Todo"​
}​
]​
}​
​
Total progress of the task.​
ErrorInfo​
String​
​
{​
"biz_context":"{​
"log_id":"88e5ed340fb4466b999bc89****",​
"tenant_id":"2100157781",​
"instance_id":"6f2fd63c0ea947b280877f5****"​
}",​
"reason":"mysql endpoint error: dial tcp 172.****",​
"kind":1,​
"app":"AppMySQLIncr2Kafka",​
"app_id":"1049"​
}​
​
Task error message.​
CreateTime​
Long​
1661242976288​
Task creation time, using milliseconds timestamp format.​
StartTime​
Long​
1661242976288​
Task start time, in milliseconds timestamp format.​
tip​
  • If this parameter is set, the query end time (that is, the EndTime) parameter is also required.​
  • If this parameter is left blank, all existing tasks under the current task type are returned by default.
EndTime​
Long​
0​
Task end time, using milliseconds timestamp format.​
tip​
  • If this parameter is set, the query end time (that is, the EndTime) parameter is also required.​
  • The end time must be later than the start time.
ProjectName​
String​
default​
Project name.​
AddSyncObjectAllowed​
Boolean​
true​
Whether modification of the synchronization object is allowed. The values are as follows:​
  • true: Indicates that the synchronization object can be modified.​
  • false: Indicates that the synchronization object cannot be modified.​
EnableDataValidation​
Boolean​
true​
Whether to enable data verification. The values are as follows:​
  • true: Indicates enabled.​
  • False: Indicates close.​
TaskSubType​
String​
Default​
Data type. The values are as follows:​
  • Default: Indicates the value of the migration or subscription task.​
  • ForwardSync: Indicates forward synchronization.​
  • BackwardSync: Indicates reverse synchronization.​
  • FullRowCountCompare: Indicates full row-count verification.​
  • FullRowCompare: Indicates full data verification.​
  • FullPkCompare: Indicates full primary key validation.​
  • IncrDataValidation: Indicates Increment validation.​
  • MetaCompare: Indicates Schema Verification.​
EnableCloudMonitor​
Boolean​
true​
Whether to enable cloud monitor, with the following values:​
  • true: Indicates enabled.​
  • false: Indicates disabled (default).​
UpdateTime​
Long​
1661242976290​
Task update time, using milliseconds timestamp format.​
SnapshotGtid​
String​
SnapshotGtid​
Full data consistency migration configuration.​
​
DataSource​
​
Name​
Type​
Example​
Description​
Category​
String​
MySQL​
The type of instance. The values are as follows:​
  • MySQL: Indicates that the instance type is MySQL.​
  • PostgreSQL: Indicates that the instance type is PostgreSQL.​
  • ElasticSearch: Indicates that the instance type is Elasticsearch.​
  • MongoDB: Indicates that the instance type is MongoDB.​
  • Redis: Indicates that the instance type is Redis.​
CreateTime​
Long​
1734070854504​
Creation time of the data source. Millisecond timestamp.​
DataSourceId​
String​
1867454442941460510​
Source or target instance ID.​
ModifyTime​
Long​
1734070873088​
The most recent time the data source was updated. Millisecond timestamp.​
EndpointType​
String​
Volc_MySQL​
The access method of the instance. the values are as follows:​
  • Volc_MySQL: Indicates BytePlus NDB for MySQL.​
  • Volc_veDB_MySQL: Indicates BytePlus NDB for MySQL.​
  • Volc_PostgreSQL: Indicates Volcengine RDS for PostgreSQL.​
  • Volc_Mongo: Indicates Volcengine Database for MongoDB.​
  • Volc_ElasticSearch: Indicates Volcengine Cloud Search Service.​
  • Volc_Kafka: Indicates Message Queue for Kafka.​
  • Volc_RocketMQ: Indicates Message Queue for RocketMQ.​
  • Volc_Redis: Indicates Volcengine Cache for Redis.​
  • Public_MySQL: Indicates MySQL connected over public network.​
  • Public_PostgreSQL: Indicates connected over public network.​
  • Public_Mongo: Indicates MongoDB connected over public network..​
  • Public_ElasticSearch: Indicates Cloud Search connected over public network.​
  • Public_Redis: Indicates Redis connected over express network.​
  • Builtin_Kafka: Indicates the built-in middleware.​
  • Express_MySQL: Indicates MySQL connected over express network.​
  • Express_PostgreSQL: Indicates PostgreSQL connected over express network.​
  • Express_Mongo: Indicates MongoDB connected over express network.​
  • Express_Redis: Indicates Redis connected over express network.​
  • Express_Kafka: Indicates Kafka connected over express network.​
  • Express_ElasticSearch: Indicates ElasticSearch connected over express network.​
  • Volc_AIDapPG: Indicates EndpointVolcAIDapPG.​
  • Volc_Milvus: indicates Volcano Engine version Milvus.​
  • Public_Milvus: indicates publicly deployed Milvus.​
  • Express_Milvus: indicates proprietary network Milvus.​
VolcMySQLSettings​
Object of VolcMySQLSettings​
​
{​
"DBInstanceId": "mysql-0b5d385f*****",​
"DBInstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-shanghai"​
},​
"Username": "huahua"​
}​
​
Indicates the information of the source or target database where the access method is Volcengine RDS for MySQL. This parameter is required when EndpointType is set to Volc_MySQL.​
VolcveDBMySQLSettings​
​
{​
"DBInstanceId": "vedbm-arjlc5di****",​
"DBInstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "root"​
}​
​
Indicates the information of the source or target database where the access method is Volcano Engine veDB for MySQL. This parameter is required when EndpointType is set to Volc_veDB_MySQL.​
VolcPostgreSQLSettings​
​
{​
"DBInstanceId": "postgres-5d17bd5c****",​
"DBInstanceName": "",​
"DBName": "huahua",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-guangzhou"​
},​
"Username": "huahua"​
}​
​
Indicates the information of the source or target database where the access method is Volcengine RDS for PostgreSQL. This parameter is required when EndpointType is set to Volc_PostgreSQL.​
VolcMongoSettings​
Object of VolcMongoSettings​
​
{​
"DBInstanceId": "mongo-replica-8ea79132****",​
"DBInstanceName": "",​
"DeployType": "ReplicaSet",​
"MongoAuthSourceDB": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-guangzhou"​
},​
"Username": "root"​
}​
​
Indicates the information of the source or target database where the access method is Volcengine Database for MongoDB. This parameter is required when EndpointType is set to Volc_Mongo.​
VolcElasticSearchSettings​
​
{​
"DBInstanceId": "o-00g0sqi*****",​
"DBInstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-shanghai"​
},​
"Username": "admin"​
}​
​
Indicates the information of the target database where the access method is Volcengine Cloud Search Service. This parameter is required when EndpointType is set to Volc_ElasticSearch.​
VolcKafkaSettings​
Object of VolcKafkaSettings​
​
{​
"AuthType": "PLAIN",​
"InstanceId": "kafka-cnnge0tckudy****",​
"InstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Topic": "huahua",​
"Username": "huahua"​
}​
​
Indicates the information of the target database when the access method is Volcengine Kafka. This parameter is required when EndpointType is set to Volc_Kafka.​
VolcRocketMQSettings​
​
{​
"AuthType": "PLAIN",​
"InstanceId": "rocketmq-cnou964d1e******",​
"InstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-guangzhou"​
},​
"Topic": "zaizai",​
"Username": "uSmQgOHNTy5Uh98nqBGPvCzK"​
}​
​
Indicates the information of the target database where the access method is Volcengine RocketMQ. This parameter is required when EndpointType is set to Volc_RocketMQ.​
VolcRedisSettings​
Object of VolcRedisSettings​
​
{​
"DBInstanceId": "redis-cnlf1xx7vjjw9****",​
"DBInstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "default"​
}​
​
Indicates the information of the target database where the access method is Volcengine Cache for Redis. This parameter is required when EndpointType is set to Volc_Redis.​
PublicMySQLSettings​
Object of PublicMySQLSettings​
​
{​
"Host": "rm-2zey7i58n36x0****.mysql.rds.aliyuncs.com",​
"Password": "******",​
"Port": 3306,​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "rootgg"​
}​
​
Indicates the source database or target database information with the access method as public network MySQL. This parameter is required when EndpointType is set to Public_MySQL.​
PublicPostgreSQLSettings​
​
{​
"DBName": "postgres",​
"Host": "aurora-pg-17-replica-instance-1.czenkuaf0oxm.ap-southeast-2.rds.amazonaws.com",​
"Password": "******",​
"Port": 5432,​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "dts"​
}​
​
Information indicating the access method is public network PostgreSQL for source database or target database. This parameter is required when EndpointType is set to Public_PostgreSQL.​
PublicMongoSettings​
Object of PublicMongoSettings​
​
{​
"DeployType": "Standalone",​
"Endpoints": [​
"123"​
],​
"MongoAuthSourceDB": "123",​
"Password": "123",​
"RegionSettings": {​
"Region": "cn-chongqing-sdv"​
},​
"Username": "123"​
}​
​
Indicates the information of the source or target database where the access method is MongoDB connected over public network. This parameter is required when EndpointType is set to Public_Mongo.​
PublicElasticSearchSettings​
​
​
{​
"Endpoints": [​
"********"​
],​
"Password": "dddd",​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "ddd"​
}​
​
Indicates information of source database or target database ElasticSearch connected over public network. This Parameter is required when EndpointType is set to Public_ElasticSearch.​
PublicRedisSettings​
Object of PublicRedisSettings​
​
{​
"Host": "redis-sy013ku146******.redis.inner.ivolces.com",​
"Password": "******",​
"Port": 6379,​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "default"​
}​
​
Information about the source database or target database with access method as Redis connected over public network. This parameter is Required when EndpointType is set to Public_Redis.​
BuiltinKafkaSettings​
​
{​
"Brokers": [​
"192.168.2.5:9092",​
"192.168.2.5:9192",​
"192.168.2.5:9292",​
"192.168.2.5:9392",​
"192.168.2.5:9492",​
"192.168.2.5:9592"​
],​
"Topic": "123e8d8a3cc54477b45db3e3c708****"​
}​
​
Indicates the parameter information for subscribing to the built-in middleware in the data subscription task. This parameter is required when EndpointType is set to Builtin_Kafka.​
ExpressMongoSettings​
​
​
{​
"DeployType": "ReplicaSet",​
"Endpoints": [​
"eee"​
],​
"MongoAuthSourceDB": "eee",​
"Password": "e",​
"PrivateNetworkSettings": {​
"SubnetId": "subnet-3jh1vsccsmjuo3pncmesj****",​
"VPCId": "vpc-30ukbt5glgyyo7r2qr2e6****"​
},​
"RegionSettings": {​
"Region": "cn-chongqing-sdv"​
},​
"Username": "e"​
}​
​
Indicates the information of the source or target database where the access method is MongoDB connected over express network. This parameter is required when EndpointType is set to Express_Mongo.​
ExpressMySQLSettings​
​
​
{​
"Host": "192.168.0.65",​
"Password": "******",​
"Port": 3306,​
"PrivateNetworkSettings": {​
"SubnetId": "subnet-2d74b6pbyewao58ozferi****",​
"VPCId": "vpc-3rebt5uf5fr405zsk2if9*****"​
},​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "rootgg"​
}​
​
Indicates the information of the source or target database where the access method is MySQL connected over express network. This parameter is required when EndpointType is set to Express_MySQL.​
ExpressPostgreSQLSettings​
​
​
{​
"DBName": "src",​
"Host": "192.168.0.65",​
"Password": "Bd2021_bd",​
"Port": 5432,​
"PrivateNetworkSettings": {​
"SubnetId": "subnet-2bznv8i16voqo2dx0efg0****",​
"VPCId": "vpc-3rebt5uf5fr405zsk2if****"​
},​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "suser"​
}​
​
Indicates the information of the source or target database where the access method is PostgreSQL connected over express network. This parameter is required when EndpointType is set to Express_PostgreSQL.​
ExpressRedisSettings​
​
​
{​
"ArchType": "Standalone",​
"Host": "192.168.32.28",​
"Password": "pwd",​
"Port": 6399,​
"PrivateNetworkSettings": {​
"SubnetId": "subnet-3re9nvjumjthc5zsk2i5z****",​
"VPCId": "vpc-2bzf04ctm2pz42dx0eebh****"​
},​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "default"​
}​
​
Indicates the information of the source database or the target database whose access method is Redis connected over express network. This parameter is required when EndpointType is set to Express_Redis.​
ExpressElasticSearchSettings​
​
{​
"Endpoints": [​
"http://192.****.0.****:9200"​
],​
"Password": "123456",​
"PrivateNetworkSettings": {​
"SubnetId": "subnet-2d6asbw971nnk58ozfeei****",​
"VPCId": "vpc-3rebt5uf5fr405zsk2if9****"​
},​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "elastic"​
}​
​
Indicates the information of the source or target database where the access method is ElasticSearch connected over express network. This parameter is required when EndpointType is set to Express_ElasticSearch.​
ExpressKafkaSettings​
​
{​
"AuthType": "PLAIN",​
"BrokerEndpoints": [​
"192.168.0.65:9092"​
],​
"Password": "admin-secret",​
"PrivateNetworkSettings": {​
"SubnetId": "subnet-2bz5swar08oao2dx0ee******",​
"VPCId": "vpc-3rebt5uf5fr405zsk2if9******"​
},​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Topic": "dial_test",​
"Username": "admin"​
}​
​
Indicates the information of the source or target database where the access method is Kafka connected over express network. This parameter is required when EndpointType is set to Express_Kafka.​
Name​
String​
test​
Task name of the data source. This parameter is required when you call the CreateDataSource API to create a data source.​
VolcMilvusSettings​
Object of VolcMilvusSettings​
​
​
{​
"DBInstanceId": "milvus-004otp******",​
"DBInstanceName": "test****",​
"Password": "test@****",​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "test****"​
}​
​
​
Indicates the information of the source database or target database with the access method as Volcengine's Milvus version. This parameter is required when the value of EndpointType is set to Volc_Milvus​
VolcAIDapPGSettings​
Object of VolcAIDapPGSettings​
​
​
{​
"RegionSettings": {​
"Region": "cn-guilin-boe"​
},​
"Workspace": "é e",​
"Branch": "é",​
"DBName": "1",​
"Username": "1·",​
"Password": "11"​
}​
​
Represents information of the source database or target database with the access method of Volc Engine version AIDAP PG. This parameter is required when the value of EndpointType is Volc_AIDapPG.​
PublicMilvusSettings​
​
​
{​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Endpoints": [​
"milvus-008ks86g******.milvus.ivolces.com:5432"​
],​
"Username": "admin",​
"Password": "admin@****"​
}​
​
​
Indicates information of the source database or target database of Milvus with public network access method. This parameter is required when the value of EndpointType is set to Public_Milvus.​
ExpressMilvusSettings​
​
​
{​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Endpoints": [​
"milvus-008ks8******.milvus.ivolces.com:5432"​
],​
"PrivateNetworkSettings": {​
"VPCId": "vpc-1a1c2ylbygnwg8nvepj*******",​
"SubnetId": "subnet-3ptgi78ypps006csxyv******"​
},​
"Username": "admin",​
"Password": "Admin@*****"​
}​
​
​
Indicates the information of the source or target database where the access method Milvus connected over express network. This parameter is required when the EndpointType value is Express_Milvus.​
VolcSupabaseSettings​
​
​
{​
"RegionSettings": {​
"Region": "cn-guangzhou"​
},​
"Workspace": "q",​
"Branch": "q",​
"DBName": "w",​
"Username": "w",​
"Password": "q"​
}​
​
Indicates information about the source database or target database with the Volcengine Supabase access method. This parameter is required when EndpointType is set to Volc_Supabase.​
PublicSupabaseSettings​
​
​
{​
"RegionSettings": {​
"Region": "cn-guangzhou"​
},​
"ApiUrl": "1",​
"ServiceKey": "2",​
"DBUrl": "2"​
}​
​
Indicates information of the source database or Target database with the access method as public network Supabase. This parameter is Required when the value of EndpointType is Public_Supabase.​
ExpressSupabaseSettings​
​
​
{​
"RegionSettings": {​
"Region": "cn-guangzhou"​
},​
"PrivateNetworkSettings": {​
"VPCId": "vpc-ghxdgjef95hc3wt3nlcmaeuj",​
"SubnetId": "subnet-22nl8dccqfjls5cp3pd01o7bh"​
},​
"ApiUrl": "我",​
"ServiceKey": "d",​
"DBUrl": "d1"​
}​
​
Indicates the information of the source or target database where the access method is Supabase connected over express network. This parameter is required when EndpointType is set to Express_Supabase.​
​
VolcMySQLSettings​
​
Name​
Type​
Example​
Description​
DBInstanceId​
String​
mysql-3d224def****​
Instance ID.​
tip​
  • This parameter is required when EndpointType is set to Volc_MySQL.​
DBInstanceName​
String​
testDB​
Instance name.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
RegionSettings​
Object of RegionSettings​
​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
CrossAccountSettings​
​
{​
"SourceAccount":"2100******",​
"Role":"test"​
}​
​
The configuration information for cross-account data transmission.​
​
RegionSettings​
​
Name​
Type​
Example​
Description​
Region​
String​
cn-beijing​
Region ID.​
​
CrossAccountSettings​
​
Name​
Type​
Example​
Description​
SourceAccount​
String​
2100******​
Source account ID.​
Role​
String​
test​
The role name created by source accounts for the transmission of data.​
​
VolcveDBMySQLSettings​
​
Name​
Type​
Example​
Description​
DBInstanceId​
String​
vedbm-r3xq0zdl****​
Instance ID.​
tip​
  • This parameter is required when EndpointType is set to Volc_veDB_MySQL.​
DBInstanceName​
String​
TestveDB​
Instance name.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
RegionSettings​
Object of RegionSettings​
​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
CrossAccountSettings​
​
{​
"SourceAccount":"2100******",​
"Role":"test"​
}​
​
The configuration information for cross-account data transmission.​
​
VolcPostgreSQLSettings​
​
Name​
Type​
Example​
Description​
DBInstanceId​
String​
postgres-h441603c68aaa****​
Instance ID.​
tip​
This parameter is required when EndpointType is set to Volc_PostgreSQL in EndpointType.
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
DBName​
String​
test****​
Database name.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
CrossAccountSettings​
​
{​
"SourceAccount":"2100******",​
"Role":"test"​
}​
​
The configuration information for cross-account data transmission.​
​
VolcMongoSettings​
​
Name​
Type​
Example​
Description​
DBInstanceId​
String​
mongo-replica-e405f8e2****​
Instance ID.​
tip​
  • This parameter is required when EndpointType is set to Volc_Mongo.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
MongoAuthSourceDB​
String​
ReplicaSet​
Account verification database. When EndpointType is set to Volc_Mongo, the default value of this parameter is root.​
DeployType​
String​
ShardedCluster​
The instance type of MongoDB. The values are as follows:​
  • ReplicaSet: Indicates a replica set.​
  • ShardedCluster: Indicates a sharded cluster.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
CrossAccountSettings​
​
{​
"SourceAccount":"2100******",​
"Role":"test"​
}​
​
The configuration information for cross-account data transmission.​
PullMethod​
String​
ChangeStream​
Incremental acquisition method at the source end. The values are as follows:​
  • ChangeStream: This method provides a way to obtain change events of specific types of modified data from a data set (database, collection, or pipeline). For example, insert, update, or delete events. If this acquisition method is selected, the instance version must be 3.6 or higher.​
  • Oplog: This acquisition method means directly obtaining the operation log of the MongoDB. For MongoDB sharded clusters, all sharding addresses must be entered after selecting this acquisition method. This method offers better synchronization performance compared to ChangeStream.​
  • None: After selecting None, incremental migration is not available. Only full migration can be selected.​
tip​
This parameter is required when the DeployType is set to ShardedCluster.
​
VolcElasticSearchSettings​
​
Name​
Type​
Example​
Description​
DBInstanceId​
String​
ztuc43y38z4w****​
Instance ID.​
tip​
  • This parameter is required when EndpointType is set to Volc_ElasticSearch.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
​
VolcKafkaSettings​
​
Name​
Type​
Example​
Description​
InstanceId​
String​
kafka-****​
Instance ID.​
tip​
  • This parameter is required when EndpointType is set to Volc_Kafka.​
AuthType​
String​
plain​
Authentication method. The default value is plain.​
Username​
String​
test****​
The username for the Kafka instance using the PLAIN mode.​
Password​
String​
test****​
The password for the Kafka instance using the PLAIN mode.​
Topic​
String​
my_topic​
Kafka's Topic name.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
​
VolcRocketMQSettings​
​
Name​
Type​
Example​
Description​
InstanceId​
String​
MQ_INST_*****​
Instance ID.​
tip​
  • This parameter is required when EndpointType is set to Volc_RocketMQ.​
  • You can call the GetInstance API to query the Instance ID.
AuthType​
String​
plain​
Authentication method. The default value is plain.​
Username​
String​
test****​
The username of the RocketMQ instance.​
Password​
String​
test****​
User password for RocketMQ instance.​
Topic​
String​
my_topic​
Topic name of RocketMQ.​
RegionSettings​
Object of RegionSettings​
​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
​
VolcRedisSettings​
​
Name​
Type​
Example​
Description​
DBInstanceId​
String​
redis-cn0212gzmh2xs****​
Instance ID.​
tip​
  • This parameter is required when EndpointType is set to Volc_Redis.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
CrossAccountSettings​
​
{​
"SourceAccount":"2100******",​
"Role":"test"​
}​
​
The configuration information for cross-account data transmission.​
​
PublicMySQLSettings​
​
Name​
Type​
Example​
Description​
Host​
String​
192.168.***.***​
The host address of the self-managed instance.​
Port​
Integer​
4​
The port number of the self-managed instance.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
SSLSettings​
Object of SSLSettings​
​
{​
"EnableSSL": true,​
"Cert":"-----BEGIN CERTIFICATE----- ...... -----END CERTIFICATE-----"​
}​
​
​
Instance encryption information.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
​
SSLSettings​
​
Name​
Type​
Example​
Description​
EnableSSL​
Boolean​
false​
Whether to enable SSL encryption connection method. The values are as follows:​
  • true: Indicates that SSL encryption is enabled.​
  • false: Indicates that SSL encryption is not enabled.​
Cert​
String​
-----BEGIN CERTIFICATE----- ...... -----END CERTIFICATE-----​
CA certificate content.​
tip​
When EnableSSL is set to true, this parameter is required.
​
PublicPostgreSQLSettings​
​
Name​
Type​
Example​
Description​
Host​
String​
192.168.***.***​
The host address of the self-managed instance.​
Port​
Integer​
4​
The port number of the self-managed instance.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
DBName​
String​
test****​
Database name.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
ExtraParams​
Array of ExtraParam​
​
​
[​
{​
"Key": "sslmode",​
"Value": "require"​
}​
]​
​
​
The parameter indicates the connection method of the instance and must be configured when connecting to PostgreSQL instances hosted on the AI native database management platform (AIDAP) through the public network or connecting to self-built instances configured with SSL.​
​
ExtraParam​
​
Name​
Type​
Example​
Description​
Key​
String​
sslmode​
Indicates enabling SSL connection method. When connecting to a PostgreSQL instance hosted on the AI native database management platform (AIDAP) via self-built public network or express network, or connecting to a self-built instance configured with SSL, this parameter must be configured with the value sslmode.​
Value​
String​
require​
Indicates enabling SSL connection method. When connecting to a PostgreSQL instance hosted on AI native Database management platform (AIDAP) via public network self-built or Virtual private cloud, or connecting to a self-built instance configured with SSL, this parameter must be configured with the value require.​
​
PublicMongoSettings​
​
Name​
Type​
Example​
Description​
RegionSettings​
Object of RegionSettings​
​
​
{​
"Region": "cn-shanghai"​
}​
​
​
The region of the instance.​
DeployType​
String​
Standalone​
The type of MongoDB instance. The values are as follows:​
  • Standalone: Indicates a single node.​
  • ReplicaSet: Indicates a replica set.​
  • ShardedCluster: Indicates a sharded cluster.​
PullMethod​
String​
ChangeStream​
Incremental acquisition method at the source end. The values are as follows:​
  • ChangeStream: This method provides a way to obtain change events of specific types of modified data from a data set (database, collection, or pipeline). For example, insert, update, or delete events. If this acquisition method is selected, the instance version must be 3.6 or higher.​
  • Oplog: This acquisition method means directly obtaining the operation log of the MongoDB. For MongoDB sharded clusters, all sharding addresses must be entered after selecting this acquisition method. This method offers better synchronization performance compared to ChangeStream.​
  • None: After selecting None, incremental migration is not available. Only full migration can be selected.​
tip​
This parameter is required when the DeployType is set to ShardedCluster.
Endpoints​
Array of String​
192.168.***.***:4​
Mongo address in the format of host:port. If multiple addresses exist, separate them with commas (,). Up to 5 addresses are supported.​
Username​
String​
test****​
mongos database account.​
Password​
String​
test****​
Database password of mongos.​
MongoAuthSourceDB​
String​
admin​
Authentication database name for mongos.​
Shards​
Array of MongoShardSetting​
​
{​
"Address": "192.168.0.1:27019,192.168.0.1:27020",​
"Username": "test****",​
"Password": "test****",​
"AuthDb": "admin"​
}​
​
Shard address information.​
tip​
If used as a return parameter, the relevant information about the parameter is not returned.
UseNewShardingDatasource​
Boolean​
true​
Whether to select the new version of shard access method, with the following optional values:​
  • false: Indicates that the new shard access method is not used.​
  • true: Indicates that the new shard method is used. The default value is the shard set scenario for the deployment type.​
​
MongoShardSetting​
​
Name​
Type​
Example​
Description​
Address​
String​
192.168.0.1:27019,192.168.0.1:27020​
Shard address, such as IP:Port or Domain:Port. If multiple addresses exist, separate them with commas (,). Up to 5 addresses are supported.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
AuthDb​
String​
admin​
Account verification database.​
​
PublicElasticSearchSettings​
​
Name​
Type​
Example​
Description​
Endpoints​
Array of String​
192.168.***.***​
The host address of the self-managed instance.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
​
PublicRedisSettings​
​
Name​
Type​
Example​
Description​
Host​
String​
192.168.***.***​
The host address of the self-managed instance.​
Port​
Integer​
4​
The port number of the self-managed instance.​
Username​
String​
test****​
Database account.​
Password​
String​
test****​
Database account password.​
DBName​
String​
test****​
Database name.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
The region of the instance.​
​
BuiltinKafkaSettings​
​
Name​
Type​
Example​
Description​
Brokers​
Array of String​
​
​
[​
"100.67.158.158:9092",​
"100.67.158.158:9192",​
"100.67.158.158:9292",​
"100.67.158.158:9392",​
"100.67.158.158:9492"​
]​
​
The IP address and port number of the Broker, in the format of host:port.​
Topic​
String​
6f2fd63c0ea947b280877f5d2a******​
Kafka's Topic ID.​
​
ExpressMongoSettings​
​
Name​
Type​
Example​
Description​
RegionSettings​
Object of RegionSettings​
​
​
{​
"Region": "cn-shanghai"​
}​
​
Region ID.​
DeployType​
String​
ShardedCluster​
The instance type of the instance. The values are as follows:​
  • Standalone: Indicates a single node.​
  • ReplicaSet: Indicates a replica set.​
  • ShardedCluster: Indicates a sharded cluster.​
PullMethod​
String​
ChangeStream​
Incremental acquisition method at the source end. The values are as follows:​
  • ChangeStream: This method provides a way to obtain change events of specific types of modified data from a data set (database, collection, or pipeline). For example, insert, update, or delete events. If this acquisition method is selected, the instance version must be 3.6 or higher.​
  • Oplog: This acquisition method means directly obtaining the operation log of the MongoDB. For MongoDB sharded clusters, all sharding addresses must be entered after selecting this acquisition method. This method offers better synchronization performance compared to ChangeStream.​
  • None: After selecting None, incremental migration is not available. Only full migration can be selected.​
tip​
This parameter is required when the DeployType is set to ShardedCluster.
PrivateNetworkSettings​
​
{​
"VpcId": "vpc-bp1opxu1zkhn00gz****",​
"SubnetId": "subnet-bpkdt37pq72zv****"​
}​
​
Configuration of the virtual private cloud.​
Endpoints​
Array of String​
192.168.***.***:4​
Mongo address in the format of host:port. If multiple addresses exist, separate them with commas (,). Up to 5 addresses are supported.​
Username​
String​
test****​
mongos database account.​
Password​
String​
test****​
Database password of mongos.​
MongoAuthSourceDB​
String​
admin​
Authentication database name for mongos.​
Shards​
Array of MongoShardSetting​
​
{​
"Address": "192.168.0.1:27019,192.168.0.1:27020",​
"Username": "test****",​
"Password": "test****",​
"AuthDb": "admin"​
}​
​
Shard address information.​
tip​
If used as a return parameter, the relevant information about the parameter is not returned.
UseNewShardingDatasource​
Boolean​
true​
Whether to select the new version of shard access method, with the following optional values:​
  • false: Indicates that the new shard access method is not used.​
  • true: Indicates that the new shard method is used. The default value is the shard set scenario for the deployment type.​
​
PrivateNetworkSettings​
​
Name​
Type​
Example​
Description​
VPCId​
String​
vpc-bp1opxu1zkhn00gz****​
VPC ID. The VPC ID values are as follows, based on the connection method of the virtual private cloud:​
  • Direct connect: Set any VPC ID of the CEN when achieving data connectivity through a dedicated line CEN.​
  • VPN connection: Set the VPC ID bound to the VPN gateway when achieving data connectivity through VPN.​
SubnetId​
String​
subnet-bpkdt37pq72zv****​
Subnet ID within the VPC ID.​
tip​
The subnet CIDR block must be added to the allowlist or security group rule of the target database.​
​
ExpressMySQLSettings​
​
Name​
Type​
Example​
Description​
Host​
String​
192.168.***.***​
The host address of the MySQL instance connected over express network.​
Port​
Integer​
4​
The port of the MySQL instance connected over express network.​
Username​
String​
test***​
Database account of MySQL instance connected over express network.​
Password​
String​
Admin@***​
Database account password of MySQL instance connected over express network.​
PrivateNetworkSettings​
​
{​
"VpcId": "vpc-bp1opxu1zkhn00gz****",​
"SubnetId": "subnet-bpkdt37pq72zv****"​
}​
​
Configuration of the virtual private cloud.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
Region ID.​
​
ExpressPostgreSQLSettings​
​
Name​
Type​
Example​
Description​
Host​
String​
192.168.***.***​
The host address of the PostgreSQL instance connected over express network.​
Port​
Integer​
4​
The port of the Express_Kafka instance connected over express network.​
Username​
String​
test***​
Database account of PostgreSQL instance connected over express network.​
Password​
String​
Admin@***​
Database account password of PostgreSQL instance connected over express network.​
DBName​
String​
test****​
Database name.​
PrivateNetworkSettings​
​
{​
"VpcId": "vpc-bp1opxu1zkhn00gz****",​
"SubnetId": "subnet-bpkdt37pq72zv****"​
}​
​
Configuration of the virtual private cloud.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
Region ID.​
ExtraParams​
Array of ExtraParam​
​
​
[​
{​
"Key": "sslmode",​
"Value": "require"​
}​
]​
​
Indicates the connection method of the instance; configure this parameter when connecting through a dedicated network to PostgreSQL instances hosted on the AI native database management platform (AIDAP) or to self-built instances configured with SSL.​
​
ExpressRedisSettings​
​
Name​
Type​
Example​
Description​
ArchType​
String​
Standalone​
Architecture type. The values are as follows:​
  • Standalone: Standalone edition.​
  • Cluster: Cluster edition.​
tip​
If the cluster of the Redis connected over express network instance has a proxy service, the ArchType must be set to Standalone.
Host​
String​
192.168.***.***​
The host address of the Redis instance connected over express network.​
tip​
This parameter is required when the parameter ArchType is set to Standalone.
Port​
Integer​
4​
The port of the Redis instance connected over express network.​
tip​
This parameter is required when the parameter ArchType is set to Standalone.
Endpoints​
Array of String​
10.10.10.10:3717​
Enter the IP: port of the primary nodes for each shard of the Cache for Redis cluster in the private network connected via the dedicated line, separated by commas. For example: ip1:port1,ip2:port2,ip3:port3.​
tip​
This parameter is required when the parameter ArchType is set to Cluster.
PrivateNetworkSettings​
​
{​
"VpcId": "vpc-bp1opxu1zkhn00gz****",​
"SubnetId": "subnet-bpkdt37pq72zv****"​
}​
​
Configuration of the virtual private cloud.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
Region ID.​
Username​
String​
test***​
Database account of the Redis instance connected over express network.​
Password​
String​
Admin@***​
Database account password of the Redis instance connected over express network.​
tip​
When the parameter ArchType is set to Cluster, passwords for multiple shards must be consistent; otherwise, connection can not be established.
​
ExpressElasticSearchSettings​
​
Name​
Type​
Example​
Description​
Endpoints​
Array of String​
[192.168.***.***]​
The host address of ElasticSearch connected over express network.​
Username​
String​
test***​
Database account of the Elasticsearch instance connected over express network.​
Password​
String​
Admin@***​
Database account password of ElasticSearch instance connected over express network.​
PrivateNetworkSettings​
​
{​
"VpcId": "vpc-bp1opxu1zkhn00gz****",​
"SubnetId": "subnet-bpkdt37pq72zv****"​
}​
​
Configuration of the virtual private cloud.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
Region ID.​
​
ExpressKafkaSettings​
​
Name​
Type​
Example​
Description​
BrokerEndpoints​
Array of String​
[10.1.***.***:9093]​
The IP address and port number of the Kafka connected over express network instance Broker, in the format of host1:port1. If there are multiple Brokers, separate them with commas (,).​
AuthType​
String​
plain​
Authentication method. The default value is plain.​
Username​
String​
test***​
Database account of the Kafka instance connected over express network.​
Password​
String​
Admin@***​
Database account password of the Kafka instance connected over express network.​
Topic​
String​
dts_sydtest​
Topic information of the Kafka instance connected over express network.​
PrivateNetworkSettings​
​
{​
"VpcId": "vpc-bp1opxu1zkhn00gz****",​
"SubnetId": "subnet-bpkdt37pq72zv****"​
}​
​
Configuration of the virtual private cloud.​
RegionSettings​
Object of RegionSettings​
​
{​
"Region": "cn-shanghai"​
}​
​
Region ID.​
​
VolcMilvusSettings​
​
Name​
Type​
Example​
Description​
Password​
String​
admin@******​
Database account password.​
Username​
String​
test****​
Database account.​
DBInstanceId​
String​
milvus-008ks8******​
Instance ID.​
DBInstanceName​
String​
test****​
Instance name.​
RegionSettings​
Object of RegionSettings​
​
​
{​
"Region": "cn-shanghai"​
}​
​
​
Region ID to which the instance belongs.​
​
VolcAIDapPGSettings​
​
Name​
Type​
Example​
Description​
Branch​
String​
br-tough-skua-dd******​
Branch ID.​
DBName​
String​
aidb​
Database name.​
Password​
String​
test******​
Database account password.​
Username​
String​
user_admin​
The name of the account.​
Workspace​
String​
frank-dill-b8*******​
Workspace ID。​
RegionSettings​
Object of RegionSettings​
cn-beijing​
The region of the instance.​
​
PublicMilvusSettings​
​
Name​
Type​
Example​
Description​
Password​
String​
test@*****​
Database account password.​
Username​
String​
test****​
Database account.​
Endpoints​
Array of String​
​
​
[​
"milvus-008ks86gpuw8.milvus.ivolces.com"​
]​
​
​
Indicates the host addresses of public network self-built Milvus instances. When multiple host addresses exist, separate them with commas (,).​
RegionSettings​
Object of RegionSettings​
​
​
{​
"Region": "cn-beijing"​
}​
​
Region ID to which the instance belongs.​
​
ExpressMilvusSettings​
​
Name​
Type​
Example​
Description​
Password​
String​
test@*****​
Database account password.​
Username​
String​
test****​
Database account.​
Endpoints​
Array of String​
​
​
[​
"milvus-008ks8******.milvus.ivolces.com:5432"​
]​
​
​
Indicates the host address of the dedicated network Milvus instance. When multiple host addresses exist, separate them with commas (,).​
RegionSettings​
Object of RegionSettings​
​
​
{​
"Region": "cn-beijing"​
}​
​
Instance's region ID.​
PrivateNetworkSettings​
​
​
{​
"VPCId": "vpc-1a1c2ylbygnwg8nvepj******",​
"SubnetId": "subnet-3ptgi78ypps006csxy******"​
}​
​
​
Configuration of the virtual private cloud.​
​
VolcSupabaseSettings​
​
Name​
Type​
Example​
Description​
Branch​
String​
br-tough-skua-dd******​
Branch ID.​
DBName​
String​
aidb​
Database name.​
Password​
String​
test****​
Database account password.​
Username​
String​
testWorkspace ID​
Database account.​
Workspace​
String​
frank-dill-b8******​
Workspace ID。​
RegionSettings​
Object of RegionSettings​
cn-guangzhou​
The region of the instance.​
​
PublicSupabaseSettings​
​
Name​
Type​
Example​
Description​
DBUrl​
String​
test​
Database URL.​
ApiUrl​
String​
postgresql://postgres:bA&H*******.kyledong.com:15433/postgres​
API UrL。​
ServiceKey​
String​
password******​
Service role key.​
RegionSettings​
Object of RegionSettings​
cn-beijing​
The region of the instance.​
​
ExpressSupabaseSettings​
​
Name​
Type​
Example​
Description​
DBUrl​
String​
test​
Database URL.​
ApiUrl​
String​
postgresql://postgres:bA&H*******.kyledong.com:15433/postgres​
API URL。​
ServiceKey​
String​
www​
Service role key.​
RegionSettings​
Object of RegionSettings​
cn-beijing​
The region of the instance.​
PrivateNetworkSettings​
​
​
{​
"VPCId": "vpc-ghxdgjef95hc3w******",​
"SubnetId": "subnet-22nl8dc****"​
}​
​
​
Configuration of the virtual private cloud.​
​
SolutionSettings​
​
Name​
Type​
Example​
Description​
SolutionType​
String​
MySQL2MySQL​
Task type. The values are as follows:​
  • MySQL2MySQL: Indicates a migration or synchronization task from MySQL to MySQL.​
  • MySQL2ES: Indicates a synchronization task from MySQL to Elasticsearch.​
  • MySQL2Kafka: Indicates a subscription task from MySQL to Kafka.​
  • MySQL2RocketMQ: Indicates a subscription task from MySQL to RocketMQ.​
  • Pg2pg: Indicates a migration or synchronization task from PostgreSQL to PostgreSQL.​
  • PG2Kafka: Indicates a subscription task from PostgreSQL to Kafka.​
  • Pg2rocketmq: Indicates a subscription task from PostgreSQL to RocketMQ.​
  • Mongo2Mongo: Indicates a migration or synchronization task from MongoDB to MongoDB.​
  • Redis2Redis: Indicates a migration or synchronization task from Redis to Redis.​
  • Milvus2Milvus: Indicates a migration or synchronization task from Milvus to Milvus.​
  • MySQL2Milvus: indicates a synchronization task from MySQL to Milvus.​
  • Mongo2RocketMQ: indicates a subscription task from MongoDB to RocketMQ.​
  • Redis2RocketMQ: indicates a subscription task from Redis to RocketMQ.​
  • MySQL2MySQLMigrationAssessment: Indicates a migration evaluation task from MySQL to MySQL.​
  • MySQL2MySQLDataValidation: Indicates a verification task from MySQL to MySQL.​
  • PG2PGDataValidation: Indicates a verification task from PostgreSQL to PostgreSQL.​
  • Mongo2MongoDataValidation: Indicates a verification task from MongoDB to MongoDB.​
  • MSSQL2MSSQL: Indicates a migration task from SQL Server to SQL Server.​
  • MySQL2MySQLRowCompare: Indicates a full validation task from MySQL to MySQL.​
  • MySQL2MySQLIncrDataValidation: Indicates an increment validation task from MySQL to MySQL.​
  • MySQL2MySQLRowCountCompare: Indicates a row verification task from MySQL to MySQL.​
  • MySQL2MySQLMetaCompare: Indicates a schema verification task from MySQL to MySQL.​
  • PG2PGRowCompare: Indicates a full data verification task from PostgreSQL to PostgreSQL.​
  • Mongo2MongoRowCompare: Indicates a full data verification task from MongoDB to MongoDB.​
  • Mongo2MongoPkCompare: Indicates a primary key validation task from MongoDB to MongoDB.​
  • Mongo2MongoIncrDataValidation: Indicates an increment validation task from MongoDB to MongoDB.​
  • Mongo2MongoRowCountCompare: Indicates a row verification task from MongoDB to MongoDB.​
  • Redis2RedisRowCompare: Indicates a full validation task from Redis to Redis.​
  • MSSQL2MSSQLRowCompare: Indicates a full validation task from SQL Server to SQL Server.​
  • MSSQL2MSSQLRowCountCompare: Indicates a row verification task from SQL Server to SQL Server.​
AutoStart​
Boolean​
false​
Whether to automatically start the task after task creation. The values are as follows:​
  • true: indicates automatic start of the task.​
  • false: (default) indicates the task does not start automatically and requires manual start.​
MySQL2MySQLSettings​
Object of MySQL2MySQLSettings​
​
{​
"ETLSettings": {​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
},​
"EnableForeignKeyChecks": false,​
"EnableFullIncr": true,​
"EnableFullTrxPartitionByChunk": false,​
"EnableTriggerPreMigration": false,​
"EnableTrxRewrite": false,​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 600​
},​
"FullTransmissionSettings": {​
"EnableFull": true,​
"Snapshot": false​
},​
"IncrTransmissionSettings": {​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLInsert",​
"StmtDMLUpdate"​
]​
},​
"MetaTransmissionSettings": {​
"EnableMeta": true​
},​
"ObjectMappings": [​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Incr",​
"Full"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Table",​
"SrcObjName": "*"​
},​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "View",​
"SrcObjName": "*"​
},​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Function",​
"SrcObjName": "*"​
},​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Procedure",​
"SrcObjName": "*"​
},​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Trigger",​
"SrcObjName": "*"​
},​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
],​
"PolicyForPrimaryKeyConflict": "Override"​
}​
​
When the SolutionType is set to MySQL2MySQL, it refers to the parameter configuration for the migration or synchronization from source instances of MySQL to target instances of MySQL. This parameter is required.​
MySQL2ESSettings​
Object of MySQL2ESSettings​
​
{​
"ESExtraArgs": {​
"Analyzer": "",​
"CustomIndexType": "",​
"IdxNameRule": "DBAndTable",​
"InsertMode": "<UNSET>",​
"ReplicaNum": 1,​
"RetryTimes": 0,​
"ShardNum": 5,​
"TZ": ""​
},​
"ETLSettings": {​
"Script": ""​
},​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 600​
},​
"FullTransmissionSettings": {​
"EnableFull": true​
},​
"IncrTransmissionSettings": {​
"EnableIncr": true,​
"Statements": [​
"StmtDMLDelete",​
"StmtDMLInsert",​
"StmtDMLUpdate"​
]​
},​
"MetaTransmissionSettings": {​
"EnableMeta": true​
},​
"ObjectMappings": [​
{​
"DestObjName": "testdb_bak",​
"MappingList": [​
{​
"DestObjName": "testdb_bak_auth_operation",​
"ObjectMappingSetting": {​
"ESMetaMappingSetting": {​
"EnableRouting": false,​
"TypeName": ""​
},​
"LastWriteWinsKey": "",​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Table",​
"SrcObjName": "auth_operation"​
}​
],​
"ObjectType": "Database",​
"SrcObjName": "testdb_bak"​
}​
],​
"PolicyForPrimaryKeyConflict": "Override"​
}​
​
​
When the SolutionType is set to MySQL2ES, it refers to the parameter configuration for the synchronization from source instances of Elasticsearch to target instances of MySQL. This parameter is required.​
MySQL2KafkaSettings​
Object of MySQL2KafkaSettings​
​
{​
"ETLSettings": {​
"Script": ""​
},​
"EnableFullIncr": true,​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 7200​
},​
"FullTransmissionSettings": {​
"EnableFull": true​
},​
"IncrTransmissionSettings": {​
"EnableIncr": true,​
"Statements": [​
"StmtDMLInsert",​
"StmtDMLUpdate",​
"StmtDMLDelete",​
"StmtDDLAll"​
]​
},​
"MetaTransmissionSettings": {​
"EnableMeta": true​
},​
"ObjectMappings": [​
{​
"DestObjName": "huahua",​
"MappingList": [​
{​
"DestObjName": "auth_operation",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Incr",​
"Full"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": true​
},​
"ObjectType": "Table",​
"SrcObjName": "auth_operation"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Full",​
"Incr",​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "huahua"​
}​
],​
"SubscriptionSettings": {​
"EnableBeginCommitMessage": false,​
"EnableMultiTopic": false,​
"Location": "",​
"PartitionPolicy": "Table",​
"Protocol": "Volc",​
"SubscribePartBeforeImage": false,​
"VPCId": "",​
"VPCSubnetId": ""​
}​
}​
​
​
When the value of SolutionType is MySQL2Kafka, it refers to the parameter configuration for subscribing source instances of MySQL to Kafka, and this parameter is required.​
MySQL2RocketMQSettings​
​
{​
"ETLSettings": {​
"Script": ""​
},​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 600​
},​
"FullTransmissionSettings": {​
"EnableFull": true​
},​
"IncrTransmissionSettings": {​
"EnableIncr": false​
},​
"MetaTransmissionSettings": {​
"EnableMeta": true​
},​
"ObjectMappings": [​
{​
"DestObjName": "database1",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectType": "Table",​
"SrcObjName": "*"​
}​
],​
"ObjectType": "Database",​
"SrcObjName": "database1"​
}​
],​
"SubscriptionSettings": {​
"EnableBeginCommitMessage": false,​
"EnableMultiTopic": false,​
"Location": "",​
"PartitionPolicy": "Table",​
"Protocol": "Volc",​
"SubscribePartBeforeImage": false,​
"VPCId": "",​
"VPCSubnetId": ""​
}​
}​
​
​
When the value of SolutionType is MySQL2RocketM, it refers to the parameter configuration for subscribing source instances of MySQL to Message Queue for RocketMQ. This parameter is required.​
PG2PGSettings​
Object of PG2PGSettings​
​
{​
"ObjectMappings": [​
{​
"ObjectType": "Database",​
"SrcObjName": "0",​
"DestObjName": "0"​
},​
{​
"ObjectType": "Table",​
"SrcObjName": "1",​
"DestObjName": "1"​
},​
{​
"ObjectType": "View",​
"SrcObjName": "2",​
"DestObjName": "2"​
},​
{​
"ObjectType": "PostSequence",​
"SrcObjName": "3",​
"DestObjName": "3"​
}​
],​
"MetaTransmissionSettings": {​
"EnableMeta": "true"​
},​
"FullTransmissionSettings": {​
"EnableMeta": "true"​
},​
"IncrTransmissionSettings": {​
"EnableMeta": "true"​
},​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 7200​
}​
}​
​
When SolutionType is set to PG2PG, it refers to the parameter configuration for migrating source instances of PostgreSQL to target instances of PostgreSQL, and this parameter is required.​
PG2KafkaSettings​
Object of PG2KafkaSettings​
​
{​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 7200​
},​
"FullTransmissionSettings": {​
"EnableFull": false​
},​
"IncrTransmissionSettings": {​
"EnableIncr": true​
},​
"MetaTransmissionSettings": {​
"EnableMeta": false​
},​
"ObjectMappings": [​
{​
"DestObjName": "public",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectType": "Table",​
"SrcObjName": "*"​
}​
],​
"ObjectType": "Database",​
"SrcObjName": "public"​
}​
],​
"SubscriptionSettings": {​
"EnableBeginCommitMessage": false,​
"EnableMultiTopic": false,​
"Location": "",​
"Protocol": "Volc",​
"SubscribePartBeforeImage": false,​
"VPCId": "vpc-3ez4xswg5j94w72200ry****",​
"VPCSubnetId": "subnet-3ez4xts0nc4qo72200r******"​
}​
}​
​
When the value of SolutionType is PG2Kafka, it refers to the parameter configuration for subscribing source instances of PostgreSQL to Kafka, and this parameter is required.​
PG2RocketMQSettings​
Object of PG2RocketMQSettings​
​
{​
"ETLSettings": {​
"Script": ""​
},​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 600​
},​
"FullTransmissionSettings": {​
"EnableFull": false​
},​
"IncrTransmissionSettings": {​
"EnableIncr": true​
},​
"MetaTransmissionSettings": {​
"EnableMeta": false​
},​
"ObjectMappings": [​
{​
"DestObjName": "public",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectType": "Table",​
"SrcObjName": "*"​
}​
],​
"ObjectType": "Database",​
"SrcObjName": "public"​
}​
],​
"SubscriptionSettings": {​
"EnableBeginCommitMessage": false,​
"EnableMultiTopic": false,​
"Location": "",​
"PartitionPolicy": "Table",​
"Protocol": "Volc",​
"SubscribePartBeforeImage": false,​
"VPCId": "",​
"VPCSubnetId": ""​
}​
}​
​
​
When the value of SolutionType is PG2RocketMQ, it refers to the parameter configuration for subscribing source instances of PostgreSQL to Message Queue for RocketMQ. This parameter is required.​
Mongo2MongoSettings​
Object of Mongo2MongoSettings​
​
{​
"TaskName": "test",​
"TrafficSpec": "Standard",​
"ProjectName": "default",​
"Tags": [​
​
],​
"CreateBackwardSyncTask": false,​
"ChargeConfig": {​
"ChargeType": "PostPaid",​
"Times": 1​
},​
"SrcConfig": {​
"EndpointType": "Public_Mongo",​
"PublicMongoSettings": {​
"RegionSettings": {​
"Region": "×××××××××"​
},​
"DeployType": "ShardedCluster",​
"PullMethod": "Oplog",​
"Endpoints": [​
"192.168..***.***:27***"​
],​
"MongoAuthSourceDB": "admin",​
"Username": "root",​
"Password": "admin",​
"Shards": [​
{​
"Username": "root",​
"Password": "admin",​
"Address": "192.168.***.***:27***,192.168.***.***:27***",​
"AuthDb": "admin"​
},​
{​
"Address": "192.168.***.***:27***,192.168.***.***:27***",​
"AuthDb": "admin",​
"Username": "root",​
"Password": "admin"​
}​
],​
"UseNewShardingDatasource": true​
}​
},​
"DestConfig": {​
"EndpointType": "Volc_Mongo",​
"VolcMongoSettings": {​
"RegionSettings": {​
"Region": "×××××××××"​
},​
"DeployType": "ShardedCluster",​
"PullMethod": "None",​
"DBInstanceId": "mongo-shard-××××××××",​
"Username": "root",​
"Password": "admin",​
"UseNewShardingDatasource": true​
}​
},​
"SolutionSettings": {​
"SolutionType": "Mongo2Mongo",​
"Mongo2MongoSettings": {​
"TaskRunType": [​
"Incr",​
"Full",​
"Meta"​
],​
"PolicyForMongoPrimaryKeyConflict": "Override",​
"ObjectMappings": [​
{​
"ObjectType": "Database",​
"SrcObjName": "test",​
"DestObjName": "test",​
"MappingList": [​
{​
"ObjectType": "Table",​
"SrcObjName": "*",​
"DestObjName": "*"​
}​
]​
}​
],​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 600​
},​
"FullTransmissionSettings": {​
"FullSyncParalell": 8,​
"EnableFull": true​
},​
"AccountTransmissionSettings": {​
"EnableAccount": false​
},​
"MetaTransmissionSettings": {​
"EnableMeta": true​
},​
"IncrTransmissionSettings": {​
"EnableIncr": true​
}​
}​
},​
"TaskType": "DataSynchronization"​
}​
​
When SolutionType is set to Mongo2Mongo, it refers to the parameter configuration for migrating source instances of MongoDB to target instances of MongoDB, and this parameter is required.​
Redis2RedisSettings​
Object of Redis2RedisSettings​
​
{​
"TaskName": "rudonxxxxx-1",​
"TaskType": "DataMigration",​
"TrafficSpec": "Compact",​
"ProjectName": "default",​
"Tags": [​
{​
"Key": "key1",​
"Value": "value1"​
}​
],​
"SrcConfig": {​
"EndpointType": "Public_Redis",​
"PublicRedisSettings": {​
"Host": "192.168.***.***",​
"Port": 4,​
"Username": "test****",​
"Password": "test****",​
"DBName": "test****",​
"RegionSettings": {​
"Region": "cn-beijing"​
}​
}​
},​
"DestConfig": {​
"EndpointType": "Volc_Redis",​
"VolcRedisSettings": {​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"DBInstanceId": "redis-cnlfe66ipof9y86qz",​
"Username": "default",​
"Password": "ASDFasdf@2020"​
}​
},​
"SolutionSettings": {​
"SolutionType": "Redis2Redis",​
"Redis2RedisSettings": {​
"ObjectMappings": [​
{​
"ObjectType": "Database",​
"SrcObjName": "0",​
"DestObjName": "0"​
},​
{​
"ObjectType": "Database",​
"SrcObjName": "1",​
"DestObjName": "1"​
},​
{​
"ObjectType": "Database",​
"SrcObjName": "2",​
"DestObjName": "2"​
}​
],​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 7200​
},​
"FullTransmissionSettings": {​
"EnableFull": true​
},​
"IncrTransmissionSettings": {​
"EnableIncr": false​
}​
}​
},​
"ChargeConfig": {​
"ChargeType": "PostPaid"​
}​
}​
​
When SolutionType is set to Redis2Redis, it refers to the parameter configuration for migrating source instances of Redis to target instances of Redis, and this parameter is required.​
EnableMsLvlLatency​
Boolean​
false​
Enable or disable millisecond-level latency monitoring. The values are as follows:​
  • true: (Default) Enable. When enabled, it provides high-precision, full-link, proactive end-to-end delay measurement, effectively improving monitoring stability and awareness of abnormal scenarios such as network interruptions and idle disconnections.​
  • false: Disabled.​
tip​
This parameter can be set when creating the following tasks:​
  • Synchronization task​
  • MySQL type​
  • MongoDB type​
  • Subscription task​
  • PostgreSQL subscription to Kafka​
  • PostgreSQL subscription to RocketMQ​
  • AIDAP subscription to RocketMQ​
MySQL2MilvusSettings​
​
​
{​
"MilvusInsertPolicy": "Insert",​
"ObjectMappings": [​
{​
"ObjectType": "Database",​
"SrcObjName": "test",​
"DestObjName": "test",​
"MappingList": [​
{​
"ObjectType": "Table",​
"SrcObjName": "users",​
"DestObjName": "users",​
"MappingList": [​
{​
"ObjectType": "Column",​
"SrcObjName": "balance",​
"DestObjName": "balance",​
"ObjectMappingSetting": {​
"EmbeddingSetting": {​
"EnableEmbedding": true,​
"VectorFieldName": "balance_vector",​
"VectorType": "FloatVector",​
"MetricType": "L2",​
"IndexType": "AUTOINDEX",​
"KeepOriginalText": false,​
"OriginalTextNewFieldName": "balance"​
}​
}​
}​
]​
}​
]​
}​
],​
"ModelSettings": {​
"ModelName": "doubao-embedding-vision",​
"EndpointID": "ep-20260317142451-hpcwl",​
"APIKey": "ark-362feb37-9c1e-4c43-9f9c-bcacc3eb7680-f8f4a",​
"Dimension": 2048,​
"Provider": "Volcengine"​
},​
"MilvusExceptionHandlePolicy": "Truncate",​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 600​
},​
"MetaTransmissionSettings": {​
"EnableMeta": true​
},​
"FullTransmissionSettings": {​
"EnableFull": true​
},​
"IncrTransmissionSettings": {​
"EnableIncr": false​
}​
}​
​
When SolutionType is set to MySQL2Milvus, this parameter configures migration from a source instance of type MySQL to a target instance of type Milvus and is required.​
Milvus2MilvusSettings​
​
​
{​
"MilvusInsertPolicy": "Insert",​
"ObjectMappings": [​
{​
"ObjectType": "Database",​
"SrcObjName": "default",​
"DestObjName": "default",​
"MappingList": [​
{​
"ObjectType": "Table",​
"SrcObjName": "*",​
"DestObjName": "*"​
}​
]​
}​
],​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 600​
},​
"FullTransmissionSettings": {​
"EnableFull": true​
}​
}​
​
​
When SolutionType is set to Milvus2Milvus, the parameter configuration for migrating a source instance of type Milvus to a target instance of type Milvus; this parameter is required.​
PG2PGRowCompareSettings​
​
​
{​
"ObjectMappings": [​
{​
"DestObjName": "ci",​
"MappingList": [​
{​
"DestObjName": "runtime_strategy,(SELECT CHR(82)||CHR(113)||CHR(72)||CHR(120) FROM DUAL WHERE 4405=4405 AND 5947=DBMS_PIPE.RECEIVE_MESSAGE(CHR(99)||CHR(119)||CHR(84)||CHR(122),3))",​
"ObjectType": "Table",​
"SrcObjName": "runtime_strategy"​
}​
],​
"ObjectType": "Database",​
"SrcObjName": "ci"​
}​
],​
"ValidationSettings": {​
"parallel_num": 8,​
"rps_limit": 0​
}​
}​
​
When SolutionType is set to PG2PGRowCompare, this parameter configuration is required for data verification task of instance type PostgreSQL.​
Supabase2SupabaseSettings​
​
​
{​
"MetaTransmissionSettings": {​
"EnableMeta": true​
},​
"FullTransmissionSettings": {​
"EnableFull": true​
},​
"IncrTransmissionSettings": {​
"EnableIncr": false​
},​
"ObjectMappings": [​
{​
"ObjectType": "Database",​
"SrcObjName": "public",​
"DestObjName": "public",​
"MappingList": [​
{​
"ObjectType": "Table",​
"SrcObjName": "*",​
"DestObjName": "*"​
}​
]​
}​
]​
}​
​
When SolutionType is set to Supabase2Supabase, this parameter configuration is required for migrating a source instance of instance type Supabase to a target instance of instance type Supabase.​
​
MySQL2MySQLSettings​
​
Name​
Type​
Example​
Description​
ObjectMappings​
Array of ObjectMapping​
​
​
[​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
]​
​
Mapping information between source and target objects.​
EnableForeignKeyChecks​
Boolean​
false​
Select whether to enable foreign key check as needed. When enabled, the tool supports migrating cascading updates and deletes of foreign keys from the source, ensuring data integrity and consistency throughout the migration. The values are as follows:​
  • true: Indicates that foreign key check is enabled.​
  • false: (default) Indicates that foreign key check is disabled.​
tip​
This parameter supports configuration only when TaskType is DataMigration.
AccountTransmissionSettings​
​
​
{​
"EnableAccount": true​
}​
​
​
Migrates specified non-system accounts and their associated permissions from the source database to the target database.​
tip​
This parameter supports configuration only when TaskType is DataMigration or DataSynchronization.
MetaTransmissionSettings​
​
​
{​
"EnableMeta": true,​
"DisablePostMeta": true​
}​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates schema migration.​
  • Data subscription: Indicates database and table schema subscription.​
  • Data synchronization: Indicates schema initialization.​
FullTransmissionSettings​
​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
When TaskType is DataSynchronization, this parameter is required.
ETLSettings​
Object of ETLSettings​
​
​
{​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
}​
​
ETL parameter configuration.​
ErrorBehaviorSettings​
​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time. Value range: 600 - 86,400, in seconds (s).​
MySQLPosition​
Object of MySQLPosition​
​
{​
"Gtid": "3e11fa47-71ca-11e1-9e33-c80aa9429562:58",​
"Gset":"f76eb90f-82a2-11e5-a162-7ca23e9126c5:3",​
"Timestamp":1679642652​
}​
​
Set to pull Binlog logs from a specified position or timestamp.​
tip​
  • When TaskType is set to DataSynchronization, this configuration parameter is not supported during full initialization.​
  • When this parameter is not set, it defaults to the earliest point in time that the system can recognize.
PolicyForPrimaryKeyConflict​
String​
Override​
Primary key conflict handling. The processing method when a row with the same primary key value already exists in the target database. The values are as follows:​
  • ThrowError: Indicates abort on conflict. An error is reported during the pre-check, and the relevant data needs to be modified manually. Otherwise, the synchronization task can not be started.​
  • Ignore: Indicates ignore on conflict. During the pre-check, rows with the same primary key value in the target database will be skipped, and the synchronization task can be started normally.​
  • Override: Overwrite on conflict. Use the source database data to overwrite the target database data. The synchronization task can be started normally.​
tip​
When set to Ignore, data inconsistency may occur, posing a risk to the business. Choose carefully.
AccountMapping​
Array of AccountMapping​
​
​
{​
"Account": "test****",​
"ResetPassword": "true",​
"Password": "*Test****"​
}​
​
The database account information to be migrated.​
tip​
This parameter supports configuration only when TaskType is DataMigration or DataSynchronization.​
EnableTrxRewrite​
Boolean​
true​
Select whether to enable transaction merging when transmitting data. Enabling transaction merging optimizes transmission tasks by combining multiple individual transactions, improving overall efficiency and performance while ensuring data consistency. When data transmission occurs frequently with large volumes, enabling transaction merging enhances the transmission efficiency.​
  • true: Indicates that transaction merging is enabled.​
  • false: (Default) Indicates that transaction merging is not enabled.​
​
ObjectMapping​
​
Name​
Type​
Example​
Description​
ObjectType​
String​
Function​
Object type. The values are as follows:​
  • Database: indicates a database.​
  • Table: indicates a table.​
  • View: indicates a view.​
  • Column: Indicates the column.​
  • Function: Indicates the function.​
  • Procedure: Indicates the procedure.​
  • Trigger: Indicates the trigger.​
  • Type: Indicates the type.​
  • Domain: Indicates the domain.​
  • Sequence: Indicates the sequence.​
  • Rule: Indicates the rule.​
  • Operator: Indicates the operator.​
  • Aggregate: Indicates the aggregate.​
  • Extension: Indicates an extension.​
  • Constraint: Indicates a constraint.​
  • PostSequence: Indicates a PostgreSQL sequence.​
  • Schema: Indicates a mode.​
  • Event: Indicates an event.​
  • DomainConstraint: Indicates a domain constraint.​
  • BlackTable: indicates a blocklist table, filtered during subscription and not synchronized to the destination.​
SrcObjName​
String​
ceshi****​
Source object name.​
tip​
When the parameter ObjectType is set to BlackTable, the table name added to the blocklist must be specified.​
DestObjName​
String​
test****​
Target object name.​
Description​
When the parameter ObjectType is set to BlackTable, the table name added to the blocklist must be specified.​
MappingList​
Array of ObjectMapping​
​
​
[​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
]​
​
Transmission task object.​
ObjectMappingSetting​
​
​
{​
"ESMetaMappingSetting": {​
"PidCol": [​
"id",​
"name"​
],​
"EnableRouting": true,​
"RoutingCol": [​
"id"​
]​
}​
}​
​
Additional parameter information that needs to be configured when synchronizing data to Elasticsearch.​
​
ObjectMappingSetting​
​
Name​
Type​
Example​
Description​
ESMetaMappingSetting​
​
{​
"PidCol": [​
"id",​
"name"​
],​
"EnableRouting": true,​
"RoutingCol": [​
"id"​
]​
}​
​
Structure mapping parameters of Elasticsearch.​
EmbeddingSetting​
Object of EmbeddingSetting​
​
​
{​
"EnableEmbedding": true,​
"VectorFieldName": "age_vector",​
"VectorType": "FloatVector",​
"MetricType": "L2",​
"IndexType": "AUTOINDEX",​
"KeepOriginalText": true,​
"OriginalTextNewFieldName": "age"​
}​
​
Vectorization configuration information of the table. Indicates converting source column data into vectorization.​
PreVectorizedSetting​
​
​
{​
"VectorType": "FloatVector",​
"MetricType": "L2",​
"IndexType": "AUTOINDEX",​
"Dimension": 128,​
"SourceEncoding": "FloatArray"​
}​
​
​
Pre-vectorization setting information. Indicates that source column data has been vectorized and is ready for synchronization.​
​
ESMetaMappingSetting​
​
Name​
Type​
Example​
Description​
PidCol​
Array of String​
["id", "name"]​
Primary key (_id) value. If this parameter is not set, the default is the column of the primary key.​
EnableRouting​
Boolean​
EnableRouting​
Whether to enable Routing. The values are as follows:​
  • true: Indicates that Routing is enabled.​
  • false: Indicates that Routing is not enabled.​
RoutingCol​
Array of String​
["id"]​
The value of _routing. This parameter is required when EnableRouting is set to true.​
​
EmbeddingSetting​
​
Name​
Type​
Example​
Description​
IndexType​
String​
AUTOINDEX​
Vector index type, currently only supported to be set as AUTOINDEX.​
MetricType​
String​
L2​
Metric type, values include: L2, IP, COSINE.​
VectorType​
String​
FloatVector​
Vector type, currently only supports FloatVector values.​
EnableEmbedding​
Boolean​
true​
Enable vectorization configuration, values are as follows:​
  • true: enables vectorization configuration.​
  • false: disables vectorization configuration.​
VectorFieldName​
String​
age_vector​
Name of vectorization.​
KeepOriginalText​
Boolean​
true​
Keep original text options are as follows:​
  • true: keep original text.​
  • false: do not keep original text.​
OriginalTextNewFieldName​
String​
test​
New column name in the original text; if empty, the original name is retained without modification.​
​
PreVectorizedSetting​
​
Name​
Type​
Example​
Description​
Dimension​
Integer​
128​
Represents the vector dimension, default is 128, with a value range of 1~32768.​
IndexType​
String​
AUTOINDEX​
Vector index type, currently only supported to be set as AUTOINDEX.​
MetricType​
String​
L2​
Metric type, values include: L2, IP, COSINE.​
VectorType​
String​
FloatVector​
Vector type, currently only supports FloatVector values.​
SourceEncoding​
String​
FloatArray​
Source data encoding format, currently only supports FloatArray value.​
​
AccountTransmissionSettings​
​
Name​
Type​
Example​
Description​
EnableAccount​
Boolean​
false​
Whether to enable user migration. The values are as follows:​
  • true: Indicates enabled.​
  • false: Indicates disabled.​
​
MetaTransmissionSettings​
​
Name​
Type​
Example​
Description​
EnableMeta​
Boolean​
true​
Whether to enable the migration or subscription of database and table structures. The values are as follows:​
  • true: Indicates enabled.​
  • false: Indicates disabled.​
DisablePostMeta​
Boolean​
true​
When you select schema migration/schema initialization as the PostgreSQL database migration/synchronization type, DTS will automatically migrate/synchronize the post-schema after incremental migration/synchronization concludes. Alternatively, you can choose to skip post-schema migration/synchronization, meaning DTS will not migrate/synchronize the post-schema.​
PostgreSQL database post-schema synchronization and migration objects include ordinary trigger, event trigger, RULE, exclusive constraint, foreign key constraint, check constraint, Domain constraint, and Sequence value setting.​
Whether to skip PostgreSQL post-schema migration or post-schema synchronization. The values are as follows:​
  • true: Indicates skipping PostgreSQL post-schema migration or post-schema synchronization.​
  • false: Indicates not skipping PostgreSQL post-schema migration or post-schema synchronization.​
​
FullTransmissionSettings​
​
Name​
Type​
Example​
Description​
EnableFull​
Boolean​
true​
Whether to enable full migration, full subscription, or full initialization. The values are as follows:​
  • true: Indicates enabled.​
  • False: indicates disabled (default value).​
Snapshot​
Boolean​
true​
Whether to enable full data consistency migration. The values are as follows:​
  • true: Indicates enabled.​
  • False: indicates disabled (default value).​
ExtraConditions​
Array of FullExtraCondition​
​
{​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
​
Full filter condition.​
RPSLimit​
Integer​
100,000​
Rows migrated or synchronized per second. The value range is 1 to 100,000, and the default value is 100,000.​
BPSLimit​
Integer​
25000​
Data volume migrated or synchronized per second. The value range is 1 to 25,000 (KB), and the default value is 25,000.​
FullSyncParalell​
Integer​
8​
Concurrency of the migration or synchronization task. The default value is 8, and the valid range is 1 to 64.​
​
FullExtraCondition​
​
Name​
Type​
Example​
Description​
Db​
String​
TestName​
The database name to be filtered.​
Table​
String​
TableName​
Table names to be filtered.​
WhereSql​
String​
id = 5​
Filtered SQL statements.​
​
IncrTransmissionSettings​
​
Name​
Type​
Example​
Description​
EnableIncr​
Boolean​
true​
Whether to enable incremental migration, incremental subscription, or incremental synchronization. The values are as follows:​
  • true: Indicates enabled.​
  • False: indicates disabled (default value).​
tip​
When TaskType is DataSynchronization, this parameter is required.
Statements​
Array of String​
​
​
[​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
​
The operation statements to be transmitted. The values are as follows:​
  • StmtDMLInsert​
  • StmtDMLUpdate​
  • StmtDMLDelete​
  • StmtDDLAll​
  • StmtDDLAlterTable​
  • StmtDDLAlterView​
  • StmtDDLCreateFunction​
  • StmtDDLCreateIndex​
  • StmtDDLCreateProcedure​
  • StmtDDLCreateTable​
  • StmtDDLCreateView​
  • StmtDDLDropIndex​
  • StmtDDLDropTable​
  • StmtDDLDropFunction​
  • StmtDDLDropProcedure​
  • StmtDDLTruncateTable​
  • StmtDDLRenameTable​
  • StmtDDLDropView​
BpsLimit​
Long​
25000​
Used to set the bandwidth rate limit for Incremental synchronization (unit: Byte/s). This takes effect when set greater than 0; leave empty or set to 0 for no limit.​
RpsLimit​
Long​
100,000​
Sets the RPS rate limit for incremental synchronization. The limit takes effect when a value greater than 0 is set; leaving it blank or setting it to 0 means no limit.​
​
ETLSettings​
​
Name​
Type​
Example​
Description​
Script​
String​
​
(defn desensitization []​
(dts/match-table "user" (dts/map-column 'id_card str/md5)))​
​
Script for streaming data ETL. For syntax information about script dependencies, refer to DSL syntax.​
​
ErrorBehaviorSettings​
​
Name​
Type​
Example​
Description​
MaxRetrySeconds​
Integer​
600​
Maximum error retry time. Value range: 600 - 86400, in seconds (s). The default value is 600 seconds.​
​
MySQLPosition​
​
Name​
Type​
Example​
Description​
Gtid​
String​
3e11fa47-71ca-11e1-9e33-c80aa9429562:58​
Indicates that the Binlogs are pulled from the specified GTID in the format of source_id:transaction_id.​
Gset​
String​
f76eb90f-82a2-11e5-a162-7ca23e9126c5:3​
Indicates that the Binlog logs are pulled from the specified GTID_EXECUTED, in the format of source_id:transaction_id. When there are multiple GTID_EXECUTEDs, they can be separated by commas (,).​
tip​
For how to obtain the instance's GTID_EXECUTED, refer to How to obtain the GTID_EXECUTED of the instance.
Timestamp​
Long​
1679642652​
Indicates that the Binlog logs are pulled from the specified timestamp.​
​
AccountMapping​
​
Name​
Type​
Example​
Description​
Account​
String​
test****​
The account name to be migrated.​
ResetPassword​
Boolean​
true​
Whether to reset the password. The values are as follows:​
  • true: Indicates resetting to a new password.​
  • false: Indicates not resetting to a new password. Default value.​
Password​
String​
*Test****​
The new password of the account to be migrated.​
​
MySQL2ESSettings​
​
Name​
Type​
Example​
Description​
MetaTransmissionSettings​
​
{​
"EnableMeta": true,​
"DisablePostMeta": true​
}​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates schema migration.​
  • Data subscription: Indicates database and table schema subscription.​
  • Data synchronization: Indicates schema initialization.​
FullTransmissionSettings​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
When TaskType is DataSynchronization, this parameter is required.
ObjectMappings​
Array of ObjectMapping​
​
[​
{​
"DestObjName": "huahua",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectType": "Table",​
"SrcObjName": "*"​
}​
],​
"ObjectType": "Database",​
"SrcObjName": "huahua"​
}​
]​
​
​
Mapping information between source and target objects.​
ETLSettings​
Object of ETLSettings​
​
{​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
}​
​
Streaming data ETL parameter configuration.​
ErrorBehaviorSettings​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time. Value range: 600 - 86400, in seconds (s).​
ESExtraArgs​
Object of ESExtraArgs​
​
{​
"IdxNameRule": "Table",​
"ShardNum": 3,​
"ReplicaNum": 1,​
"TZ": "UTC +08:00",​
"RetryTimes": 600,​
"Analyzer": "standard",​
"InsertMode": "Replace"​
}​
​
Parameter information when synchronizing to Elasticsearch.​
PolicyForPrimaryKeyConflict​
String​
ThrowError​
Primary key conflict handling. The processing method when a row with the same primary key value already exists in the target database. The values are as follows:​
  • ThrowError: Indicates abort on conflict. An error is reported during the pre-check, and the relevant data needs to be modified manually. Otherwise, the synchronization task can not be started.​
  • Ignore: Indicates ignore on conflict. During the pre-check, rows with the same primary key value in the target database will be skipped, and the synchronization task can be started normally.​
  • Override: Overwrite on conflict. Use the source database data to overwrite the target database data. The synchronization task can be started normally.​
tip​
When set to Ignore, it may cause data inconsistency and pose risks to business. Select with caution.
​
ESExtraArgs​
​
Name​
Type​
Example​
Description​
IdxNameRule​
String​
Table​
Index concatenation rule​
  • Table: Indicates the table name concatenation method is used.​
  • DBAndTable: Indicates the database name + table name concatenation method is used.​
ShardNum​
Long​
3​
Number of shard(s)​
ReplicaNum​
Long​
1​
Number of copies.​
TZ​
String​
UTC +08:00​
Time zone. Supports UTC-12:00 to +13:00. The default value is the time zone of the Region.​
RetryTimes​
Long​
7200​
Error retry time.​
Analyzer​
String​
standard​
The supported analyzer.​
InsertMode​
String​
Replace​
Insert in the source end. The values are as follows:​
  • Replace: Indicates that when a corresponding index does not exist on the target end, a new data entry will be inserted; when a corresponding index does exist, the corresponding index will be updated.​
  • Update: Indicates that when a corresponding index does not exist on the target end, it will be skipped. When a corresponding index exists on the target end, the corresponding data will be updated.​
​
MySQL2KafkaSettings​
​
Name​
Type​
Example​
Description​
SubscriptionSettings​
​
{​
"Protocol": "Volc",​
"PartitionPolicy": "P0",​
"VPCId": "vpc-bp1opxu1zkhn00gz****",​
"VPCSubnetId": "AttachPoints.1.SubnetId=subnet-2fexiqjlgjif45oxruvso****&AttachPoints.2.SubnetId=subnet-7rtsu6whhle6j****",​
"EnableBeginCommitMessage": false,​
"SubscribePartBeforeImage": false​
}​
​
Configuration information of the subscription task object.​
ObjectMappings​
Array of ObjectMapping​
​
[​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
]​
​
Mapping information between source and target objects.​
ETLSettings​
Object of ETLSettings​
​
{​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
}​
​
ETL parameter configuration.​
ErrorBehaviorSettings​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time.​
MetaTransmissionSettings​
​
{​
"EnableMeta": true,​
"DisablePostMeta": true​
}​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates schema migration.​
  • Data subscription: Indicates database and table schema subscription.​
  • Data synchronization: Indicates schema initialization.​
FullTransmissionSettings​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
When TaskType is DataSynchronization, this parameter is required.
MySQLPosition​
Object of MySQLPosition​
​
{​
"Gtid": "3e11fa47-71ca-11e1-9e33-c80aa9429562:58",​
"Gset": "f76eb90f-82a2-11e5-a162-7ca23e9126c5:3",​
"Timestamp": 1679642652​
}​
​
Set to pull Binlog logs from a specified position or timestamp. ​
tip​
  • This parameter configuration is not supported during full initialization.​
  • When this parameter is not set, it defaults to the earliest point in time that the system can recognize.
​
SubscriptionSettings​
​
Name​
Type​
Example​
Description​
Protocol​
String​
Volc​
The subscription format. The values are as follows:​
  • Volc: Indicates Volcano Engine Proto.​
  • Canal: Indicates Canal Proto.​
  • CanalJSON: Indicates Canal JSON.​
  • Avro: Indicates the Avro format.​
  • DebeziumJSON: DebeziumJSON: Indicates Debezium JSON format.​
tip​
For details on subscription formats, refer to Data subscription format.​
When Protocol is set to DebeziumJSON, ProgressType can not be set to Meta.​
PartitionPolicy​
String​
P0​
The Partition reception policy for the Topic. The values are as follows:​
  • P0: Indicates unified delivery to Partition 0.​
  • Table: Indicates delivery to different Partitions based on the combined hash value of the database name and table name.​
  • Key: Indicates deliver to different Partitions based on the hash value of the primary key.​
tip​
When TaskType is DataSubscription, configuring this parameter is supported in the following cases:​
  • EndpointType is set to Volc_Kafka.​
  • The parameter can be set when Volc_RocketMQ is used.​
VPCId​
String​
vpc-bp1opxu1zkhn00gz****​
VPC ID.​
VPCSubnetId​
String​
AttachPoints.1.SubnetId=subnet-2fexiqjlgjif45oxruvso****&AttachPoints.2.SubnetId=subnet-7rtsu6whhle6j****​
Subnet ID within the VPC ID.​
tip​
The subnet in the target VPC must have at least one available IP.
EnableBeginCommitMessage​
Boolean​
false​
Set whether to subscribe to messages by transaction as needed to ensure message consistency and completeness. The values are as follows:​
  • true: Indicates subscription to Begin/Commit messages.​
  • false: (Default) Indicates no subscription to Begin/Commit messages.​
tip​
The following conditions must be met to configure this parameter:​
  • Protocol selects Volc, Canal, CanalJSON or Avro.​
  • EndpointType selects Builtin_Kafka, and EndpointType selects Volc_Kafka or Express_Kafka.​
  • The EndpointType is set to Volc_Kafka or Express_Kafka, and the PartitionPolicy must be set to P0.
SubscribePartBeforeImage​
Boolean​
true​
​
Set whether to subscribe to all fields as needed. The values are as follows:​
  • true: (Default) Indicates the before-image of all fields is subscribed.​
  • false: Indicates that only the before-image of changed fields is subscribed.​
tip​
This parameter can be configured only when the Instance type is MySQL, the middleware access method is Message Queue for Kafka or Kafka connected over express network, and the Subscription format is Canal JSON.​
TimeZoneLocation​
String​
Asia/Shanghai​
This parameter specifies the output time zone of the Timestamp type in data subscription (default is UTC). If downstream requires parsing in local time zone or alignment with business time, you can select the corresponding time zone as needed. The values are as follows:​
  • Asia/Shanghai: represents China Standard Time (no daylight saving time, fixed: UTC+8).​
  • America/New_York: represents US East Time (standard time: UTC-5, daylight saving time: UTC-4).​
  • America/Los_Angeles: represents US West Time (standard time: Coordinated Universal Time-8, daylight saving time: Coordinated Universal Time-7).​
  • Europe/London: represents UK Time (standard time: Coordinated Universal Time+0, daylight saving time: Coordinated Universal Time+1).​
  • Asia/Tokyo: represents Japan Time (no distinction between standard and daylight saving time, fixed: Coordinated Universal Time+9).​
  • Asia/Kolkata: represents India Time (no daylight saving time, fixed: UTC+5:30).​
  • UTC: represents Coordinated Universal Time (no daylight saving time, fixed: UTC+0).​
  • Europe/Berlin: represents Germany Time (standard time: UTC+1, daylight saving time: UTC+2).​
  • Asia/Singapore: represents Singapore Time (no daylight saving time, fixed: UTC+8).​
tip​
This parameter is supported only when the Instance type is MySQL, the middleware access method is Message Queue for Kafka, Kafka connected over express network, or Message Queue RocketMQ, and the subscription method includes at least one of full subscription or incremental subscription.​
DisableScientificNotationForFloat​
Boolean​
false​
Select whether to use disable scientific notation based on the numeric type for MySQL data <a i=1>write</a> to Kafka; options are as follows:​
  • false: When false is selected, data of type FLOAT and DOUBLE will be converted to regular numerical format, disabling scientific notation.​
  • This parameter is supported only when the Instance type is MySQL, the middleware access method is Message Queue for Kafka, Kafka connected over express network, or Message Queue RocketMQ, and the subscription method includes at least one of full subscription or incremental subscription.​
  • This method changes the output format of subscription data; configure it carefully according to downstream requirements.​
  • true: use disable scientific notation.​
​
MySQL2RocketMQSettings​
​
Name​
Type​
Example​
Description​
SubscriptionSettings​
​
{​
"Protocol": "Volc",​
"PartitionPolicy": "P0",​
"VPCId": "vpc-bp1opxu1zkhn00gz****",​
"VPCSubnetId": "subnet-7rtsu6whhle6j****",​
"EnableBeginCommitMessage": true,​
"SubscribePartBeforeImage": true​
}​
​
​
Configuration information of the subscription task object.​
ObjectMappings​
Array of ObjectMapping​
​
[​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
]​
​
Mapping information between source and target objects.​
ETLSettings​
Object of ETLSettings​
​
{​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
}​
​
Streaming data ETL parameter configuration.​
ErrorBehaviorSettings​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time. Value range: 600 - 86400, in seconds (s).​
MetaTransmissionSettings​
​
{​
"EnableMeta": true,​
"DisablePostMeta": true​
}​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates schema migration.​
  • Data subscription: Indicates database and table schema subscription.​
  • Data synchronization: Indicates schema initialization.​
FullTransmissionSettings​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
When TaskType is DataSynchronization, this parameter is required.
MySQLPosition​
Object of MySQLPosition​
​
{​
"Gtid": "3e11fa47-71ca-11e1-9e33-c80aa9429562:58",​
"Gset": "f76eb90f-82a2-11e5-a162-7ca23e9126c5:3",​
"Timestamp": 1679642652​
}​
​
Set to pull Binlog logs from a specified position or timestamp.​
tip​
  • This parameter configuration is not supported during full initialization.​
  • When this parameter is not set, it defaults to the earliest point in time that the system can recognize.​
​
PG2PGSettings​
​
Name​
Type​
Example​
Description​
MetaTransmissionSettings​
​
{​
"EnableMeta": true,​
"DisablePostMeta": true​
}​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates schema migration.​
  • Data subscription: Indicates database and table schema subscription.​
  • Data synchronization: Indicates schema initialization.​
FullTransmissionSettings​
​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
When TaskType is DataSynchronization, this parameter is required.
ObjectMappings​
Array of ObjectMapping​
​
[​
{​
"DestObjName": "huahua",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectType": "Table",​
"SrcObjName": "*"​
}​
],​
"ObjectType": "Database",​
"SrcObjName": "huahua"​
}​
]​
​
​
Mapping information between source and target objects.​
ETLSettings​
Object of ETLSettings​
​
{​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
}​
​
​
ETL parameter configuration.​
ErrorBehaviorSettings​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time. Value range: 600 - 86400, in seconds (s).​
SkipNoPermissionTables​
Boolean​
​
​
​
PG2KafkaSettings​
​
Name​
Type​
Example​
Description​
SubscriptionSettings​
​
{​
"Protocol": "Volc",​
"PartitionPolicy": "P0",​
"VPCId": "vpc-bp1opxu1zkhn00gz****",​
"VPCSubnetId": "subnet-7rtsu6whhle6j****",​
"EnableBeginCommitMessage": true,​
"SubscribePartBeforeImage": true​
}​
​
Configuration information of the subscription task object.​
ObjectMappings​
Array of ObjectMapping​
​
[​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
]​
​
​
Mapping information between source and target objects.​
ETLSettings​
Object of ETLSettings​
​
{​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
}​
​
ETL parameter configuration.​
ErrorBehaviorSettings​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time.​
MetaTransmissionSettings​
​
{​
"EnableMeta": true,​
"DisablePostMeta": true​
}​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates schema migration.​
  • Data subscription: Indicates database and table schema subscription.​
  • Data synchronization: Indicates schema initialization.​
FullTransmissionSettings​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
When TaskType is DataSynchronization, this parameter is required.
SkipNoPermissionTables​
Boolean​
true​
Select whether to automatically skip tables without permission as needed. The values are as follows:​
  • true: Enable automatic skip tables without permission. When encountering tables without sufficient permissions, the system will automatically skip them without interrupting the task. However, data loss may occur, potentially causing business anomalies. It is recommended to configure event alert rules simultaneously.​
  • false: Disables Automatic skip tables without permission.​
​
PG2RocketMQSettings​
​
Name​
Type​
Example​
Description​
SubscriptionSettings​
​
{​
"Protocol": "Volc",​
"PartitionPolicy": "P0",​
"VPCId": "vpc-bp1opxu1zkhn00gz****",​
"VPCSubnetId": "subnet-7rtsu6whhle6j****",​
"EnableBeginCommitMessage": true,​
"SubscribePartBeforeImage": true​
}​
​
Configuration information of the subscription task object.​
ObjectMappings​
Array of ObjectMapping​
​
​
[​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
]​
​
​
Mapping information between source and target objects.​
ETLSettings​
Object of ETLSettings​
​
​
{​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
}​
​
​
ETL parameter configuration.​
ErrorBehaviorSettings​
​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time.​
MetaTransmissionSettings​
​
​
{​
"EnableMeta": true,​
"DisablePostMeta": true​
}​
​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates schema migration.​
  • Data subscription: Indicates database and table schema subscription.​
  • Data synchronization: Indicates schema initialization.​
FullTransmissionSettings​
​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
  • This parameter is required when TaskType is set to DataSynchronization.​
SkipNoPermissionTables​
Boolean​
true​
Select whether to automatically skip tables without permission as needed. The values are as follows:​
  • true: Enable automatic skip tables without permission. When encountering tables without sufficient permissions, the system will automatically skip them without interrupting the task. However, data loss may occur, potentially causing business anomalies. It is recommended to configure event alarm rules simultaneously. For detailed operations, refer to CreateEventRule.​
  • false: Disable automatic skip tables without permission.​
SkipMessageOverMaxLength​
Boolean​
true​
Select whether to automatically skip oversized messages as needed.​
  • true: when the message exceeds the limit, the system automatically skips it without interrupting the task, but business may be abnormal due to data loss; it is recommended to configure configuration event alarm rules at the same time. For detailed operations, refer to CreateEventRule.​
  • false: Indicates not to automatically skipping oversized messages.​
Description​
This parameter supports configuration when subscribing to Volcengine AIDAP edition PostgreSQL database via RocketMQ message queue.​
​
Mongo2MongoSettings​
​
Name​
Type​
Example​
Description​
ObjectMappings​
Array of ObjectMapping​
​
​
[​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
]​
​
Mapping information between source and target objects.​
MetaTransmissionSettings​
​
{​
"EnableMeta": true,​
"DisablePostMeta": true​
}​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates schema migration.​
  • Data subscription: Indicates database and table schema subscription.​
  • Data synchronization: Indicates schema initialization.​
FullTransmissionSettings​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
When TaskType is DataSynchronization, this parameter is required.
ETLSettings​
Object of ETLSettings​
​
{​
"Script": "(defn desensitization []\n (dts/match-table \"user\" (dts/map-column 'id_card str/md5)))"​
}​
​
ETL parameter configuration.​
ErrorBehaviorSettings​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time.​
AccountMapping​
Array of AccountMapping​
​
​
{​
"Account": "test****",​
"ResetPassword": "true",​
"Password": "*Test****"​
}​
​
Database account information to be synchronized.​
tip​
This parameter is supported only when TaskType is set to DataSynchronization.​
AccountTransmissionSettings​
​
​
{​
"EnableAccount": true​
}​
​
Migrates specified non-system accounts and their associated permissions from the source database to the target database.​
tip​
This parameter is supported only when TaskType is set to DataSynchronization.​
​
Redis2RedisSettings​
​
Name​
Type​
Example​
Description​
ObjectMappings​
Array of ObjectMapping​
​
[​
{​
"DestObjName": "test",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta"​
],​
"PolicyForKeyConflict": "TableNone",​
"SetObjectTransType": false​
},​
"ObjectType": "Event",​
"SrcObjName": "*"​
}​
],​
"ObjectMappingSetting": {​
"LastWriteWinsKey": "",​
"ObjectTransTypes": [​
"Meta",​
"Full",​
"Incr"​
],​
"PolicyForKeyConflict": "TableOverride",​
"SetObjectTransType": true​
},​
"ObjectType": "Database",​
"SrcObjName": "test"​
}​
]​
​
Mapping information between source and target objects.​
FullTransmissionSettings​
​
{​
"EnableFull": true,​
"Snapshot": true,​
"RPSLimit": 100000,​
"BPSLimit": 25000,​
"FullSyncParalell": 8,​
"ExtraConditions": {​
"Db": "TestName",​
"Table": "TableName",​
"WhereSql": "id = 5"​
}​
}​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates full migration.​
  • Data subscription: Indicates full subscription.​
  • Data synchronization: Indicates full initialization.​
IncrTransmissionSettings​
​
{​
"EnableIncr": true,​
"Statements": [​
"StmtDDLAll",​
"StmtDMLDelete",​
"StmtDMLUpdate",​
"StmtDMLInsert"​
]​
}​
​
Parses and replays the target database incremental log. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data migration: Indicates incremental migration.​
  • Data subscription: Indicates incremental subscription.​
  • Data synchronization: Indicates incremental synchronization.​
tip​
When TaskType is DataSynchronization, this parameter is required.
ErrorBehaviorSettings​
​
{​
"MaxRetrySeconds": 7200​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time.​
EnableKSN​
Boolean​
false​
Enable KSN for incremental synchronization as needed. After enabling, DTS will use Redis keyspace notification to capture incremental data changes that Redis native replication protocol cannot transmit. The values are as follows:​
  • true: indicates KSN is enabled.​
  • false: (default) indicates KSN is not enabled.​
tip​
Because the KSN mechanism depends on Redis service's real-time message push, it is highly sensitive to performance. Before enabling this feature, consider the following risks:​
  • High performance overhead: KSN increases CPU and network load on the source database, which may put significant pressure on online business operations.​
  • Prohibited in large key scenarios: Frequent operations on large keys can easily cause KSN message backlog or timeout, leading to synchronization task failure.​
  • Data consistency risk: KSN cannot guarantee 100% reliable message delivery. Network fluctuations or high source database load may cause message loss, resulting in inconsistent primary and standby data.​
  • SLA not guaranteed: Due to the above instabilities, synchronization links enabled with this feature are not covered by standard SLA protection.​
​
MySQL2MilvusSettings​
​
Name​
Type​
Example​
Description​
ModelSettings​
Object of ModelSettings​
​
​
{​
"ModelName": "doubao-embedding-vision",​
"EndpointID": "ep-20260317142451-hpcwl",​
"APIKey": "ark-362feb37-9c1e-4c43-9f9c-bcacc3eb7680-f8f4a",​
"Dimension": 2048,​
"Provider": "Volcengine"​
}​
​
Core parameters and behavioral rules of the large model application.​
MySQLPosition​
Object of MySQLPosition​
​
​
{​
"Gtid": "3e11fa47-71ca-11e1-9e33-c80aa9429562:58",​
"Gset": "f76eb90f-82a2-11e5-a162-7ca23e9126c5:3",​
"Timestamp": 1679642652​
}​
​
​
Set to pull Binlog logs from a specified position or timestamp. ​
tip​
  • This parameter configuration is not supported during full initialization.​
  • When this parameter is not set, it defaults to the earliest point in time that the system can recognize.​
ObjectMappings​
Array of ObjectMapping​
​
​
[​
{​
"ObjectType": "Database",​
"SrcObjName": "test",​
"DestObjName": "test",​
"MappingList": [​
{​
"ObjectType": "Table",​
"SrcObjName": "users",​
"DestObjName": "users",​
"MappingList": [​
{​
"ObjectType": "Column",​
"SrcObjName": "balance",​
"DestObjName": "balance",​
"ObjectMappingSetting": {​
"EmbeddingSetting": {​
"EnableEmbedding": true,​
"VectorFieldName": "balance_vector",​
"VectorType": "FloatVector",​
"MetricType": "L2",​
"IndexType": "AUTOINDEX",​
"KeepOriginalText": false,​
"OriginalTextNewFieldName": "balance"​
}​
}​
}​
]​
}​
]​
}​
]​
​
​
Mapping information between source and target objects.​
VectorSourceMode​
String​
EmbeddingRequired​
Vectorization method, with the following values:​
  • EmbeddingRequired: indicates the source end has scalar values that require conversion into vectors through an embedding model.​
  • PreVectorized: indicates the source fields already include serialized vector data and only need parsing, not embedding.​
MilvusInsertPolicy​
String​
Insert​
Write mode for data, with the following values:​
  • Insert: When using Insert to write data, Milvus does not check the uniqueness of the primary key on the destination and writes data directly. The Insert write mode applies to scenarios where the collection has AutoID enabled and data (including primary key) on the source and target ends are consistent. When DTS restarts or fetches data repeatedly, it may cause data redundancy in the destination.​
  • Upsert: When using Upsert to write data, Milvus checks whether the primary key exists at the destination. If it does not exist, data is written directly. If it exists, the original data is deleted and the new data is written. When the Collection has AutoID enabled, Milvus ignores the primary key information of the original data and generates a new primary key. Upsert write mode applies to updating existing data when the Collection does not have AutoID enabled, or when Collection has AutoID enabled but business or verification does not rely on the primary key. When DTS restarts or fetches data repeatedly, it may lead to primary key inconsistency, affecting business or verification that depends on the primary key.​
Whether Milvus enables AutoID and the choice of write mode have a significant impact on business. For more information, refer to Milvus primary field and automatic recognition.​
ErrorBehaviorSettings​
​
​
{​
"MaxRetrySeconds": 600​
}​
​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time. The default value is 600, with a range of 600 to 86400 seconds (s).​
FullTransmissionSettings​
​
​
{​
"EnableFull": true​
}​
​
Fully read the source table content and write it to the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data synchronization: Indicates full initialization.​
MetaTransmissionSettings​
​
​
{​
"EnableFull": true​
}​
​
Reads the source database and table schema definition syntax and reassembles it into the syntax format of the target database. The meaning of this parameter varies depending on the task, as detailed below:​
  • Data synchronization: Indicates schema initialization.​
MilvusExceptionHandlePolicy​
String​
Truncate​
Set the system's response when data type mismatches, length limits exceeded, or format errors occur during data import, field mapping, or ETL processes as needed. Values are as follows:​
  • TRUNCATE (truncate): automatically trim overlength characters to fit field length. Applicable to non-key fields (such as remarks), but may lead to information loss.​
  • SKIP (discard field): automatically skip erroneous data and continue processing the next record. Applicable to scenarios tolerating partial data loss, with log review recommended afterwards.​
  • FAIL (abort): stops the task immediately upon any exception. Suitable for core businesses like finance to ensure absolute data accuracy, but data must be cleaned in advance.​
​
ModelSettings​
​
Name​
Type​
Example​
Description​
APIKey​
String​
ark-dc43737e-e4ca-4ade-a94f-***********​
Authorization credential for calling the large model or application. For details on how to obtain the API key, refer to Manage API key.​
Dimension​
Integer​
2048​
Output vector length of the multimodal vectorization <a i=1>model</a>, with the following values:​
  • 2048: (recommended) preserves richer semantic information, suitable for scenarios prioritizing retrieval effectiveness.​
  • 1024: reduces resource consumption for storage, index construction, and queries, suitable for scenarios sensitive to performance, cost, or large-scale data.​
ModelName​
String​
doubao-embedding-vision​
Vectorization configuration model, currently only supporting the value doubao-embedding-vision​
EndpointID​
String​
ep-20260317142451-hpcwl​
Set the entry for calling the large model inference service on demand.​
​
Milvus2MilvusSettings​
​
Name​
Type​
Example​
Description​
ObjectMappings​
Array of ObjectMapping​
​
​
[​
{​
"ObjectType": "Database",​
"SrcObjName": "default",​
"DestObjName": "default",​
"MappingList": [​
{​
"ObjectType": "Table",​
"SrcObjName": "*",​
"DestObjName": "*"​
}​
]​
}​
]​
​
Mapping information between source and target objects.​
MilvusInsertPolicy​
String​
Insert​
Write mode of source end data in the target, with values as follows:​
  • Insert: Insert data directly using Insert. This applies when Collection has AutoID enabled and data in the source and destination (including primary key) are consistent. When DTS restarts or fetches data repeatedly, it may cause data redundancy in the destination.​
  • Upsert: Use Upsert to directly insert data or update existing data. This is suitable for updating existing data when Collection does not have AutoID enabled, or when Collection has AutoID enabled but business or verification does not rely on the primary key. When DTS restarts or fetches data repeatedly, it may lead to primary key inconsistency, affecting business or verification that depends on the primary key.​
ErrorBehaviorSettings​
​
​
{​
"MaxRetrySeconds": 600​
}​
​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time. The default value is 600, with a range of 600 to 86400 seconds (s).​
FullTransmissionSettings​
​
​
{​
"EnableFull": true​
}​
​
​
Fully read the source table content and write it to the target database.​
​
PG2PGRowCompareSettings​
​
Name​
Type​
Example​
Description​
ObjectMappings​
Array of ObjectMapping​
​
​
[​
{​
"DestObjName": "ci",​
"MappingList": [​
{​
"DestObjName": "runtime_strategy,(SELECT CHR(82)||CHR(113)||CHR(72)||CHR(120) FROM DUAL WHERE 4405=4405 AND 5947=DBMS_PIPE.RECEIVE_MESSAGE(CHR(99)||CHR(119)||CHR(84)||CHR(122),3))",​
"ObjectType": "Table",​
"SrcObjName": "runtime_strategy"​
}​
]​
​
​
Data verification object​
ValidationSettings​
Object of ValidationSettings​
​
​
{​
"parallel_num": 8,​
"rps_limit": 0​
}​
​
​
​
ValidationSettings​
​
Name​
Type​
Example​
Description​
rps_limit​
Long​
0​
Indicates the rate limit for initiating verification tasks. Setting to 0 means no limit​
parallel_num​
Long​
8​
Indicates the number of parallel threads or shards concurrently executing the data verification task.​
​
Supabase2SupabaseSettings​
​
Name​
Type​
Example​
Description​
SupabaseDBTransmissionSettings​
​
​
{​
"MetaTransmissionSettings": {​
"EnableMeta": true​
},​
"FullTransmissionSettings": {​
"EnableFull": true​
},​
"IncrTransmissionSettings": {​
"EnableIncr": false​
},​
"ObjectMappings": [​
{​
"ObjectType": "Database",​
"SrcObjName": "kyle_pm_e2e_20260525_175001",​
"DestObjName": "kyle_pm_e2e_20260525_175001",​
"MappingList": [​
{​
"ObjectType": "Table",​
"SrcObjName": "*",​
"DestObjName": "*"​
}​
]​
}​
]​
}​
​
Information on migrated database objects.​
SupabaseStorageTransmissionSettings​
​
​
{​
"FullTransmissionSettings": {​
"EnableFull": true​
},​
"ObjectMappings": [​
{​
"ObjectType": "Bucket",​
"SrcObjName": "stress_test_bucket_1",​
"DestObjName": "stress_test_bucket_1",​
"MappingList": [​
​
]​
}​
]​
}​
​
Storage object information.​
​
SupabaseDBTransmissionSettings​
​
Name​
Type​
Example​
Description​
ObjectMappings​
Array of ObjectMapping​
​
​
[​
{​
"ObjectType": "Database",​
"SrcObjName": "kyle_pm_e2e_20260525_175001",​
"DestObjName": "kyle_pm_e2e_20260525_175001",​
"MappingList": [​
{​
"ObjectType": "Table",​
"SrcObjName": "*",​
"DestObjName": "*"​
}​
]​
}​
]​
​
Migration object information.​
ErrorBehaviorSettings​
​
​
{​
"MaxRetrySeconds": 600​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time. Value range: 600 - 86,400, in seconds (s).​
FullTransmissionSettings​
​
​
{​
"EnableFull": true​
}​
​
During full migration, read source table content and write it to the corresponding target database information.​
IncrTransmissionSettings​
​
​
{​
"EnableIncr": false​
}​
​
​
Read source table content and write to corresponding target database information during incremental migration.​
MetaTransmissionSettings​
​
​
{​
"EnableFull": true​
}​
​
Schema migration reads the source table data and writes it to the corresponding target database information.​
​
SupabaseStorageTransmissionSettings​
​
Name​
Type​
Example​
Description​
ObjectMappings​
Array of ObjectMapping​
​
​
[​
{​
"ObjectType": "Bucket",​
"SrcObjName": "stress_test_bucket_1",​
"DestObjName": "stress_test_bucket_1",​
"MappingList": [​
​
]​
}​
]​
​
Migration object information.​
ErrorBehaviorSettings​
​
​
{​
"MaxRetrySeconds": 600​
}​
​
Error retry time. If the source database or target database disconnects, the task automatically recovers if reconnection occurs within that time. Value range: 600 - 86,400, in seconds (s).​
FullTransmissionSettings​
​
​
{​
"EnableFull": true​
}​
​
Full migration reads the content of the source storage object and writes it to the corresponding target database.​
​
ChargeDetailObject​
​
Name​
Type​
Example​
Description​
ChargeStartTime​
Long​
1668569330000​
The time when the task starts billing, in milliseconds timestamp.​
ChargeStatus​
String​
Normal​
Task order state. The values are as follows:​
  • Init: The order is to be started.​
  • Normal: The order is in a normal state.​
  • Overdue: The order is overdue.​
  • Unpaid: The order is unpaid.​
ChargeType​
String​
Postpaid​
Billing method, with the following values:​
  • NotEnabled: Indicates that billing is disable.​
  • PostPaid: Indicates pay-as-you-go.​
  • PrePaid: Indicates subscription.​
OrderNo​
String​
Order7166450525830******​
Billing order ID.​
ChargeEndTime​
Long​
1888569330000​
The time when the task ends billing, in milliseconds timestamp.​
​
ChargeConfig​
​
Name​
Type​
Example​
Description​
ChargeType​
String​
PrePaid​
Billing method, with the following values:​
  • NotEnabled: Indicates that billing is disable.​
  • PostPaid: Indicates pay-as-you-go.​
  • PrePaid: Indicates subscription.​
Times​
Integer​
12​
Purchase duration.​
tip​
This configuration is supported when ChargeType is set to PrePaid.
AutoRenew​
Boolean​
true​
Whether to renew automatically. The values are as follows:​
  • true: Indicates automatic renewal.​
  • false: Indicates no automatic renewal. Default value.​
OneStep​
Boolean​
false​
Whether to pay immediately. The values are as follows:​
  • true: Indicates immediate payment.​
  • false: Indicates no immediate payment. Default value.​
​
ProgressSummary​
​
Name​
Type​
Example​
Description​
Infos​
​
{​
"Infos": [​
{​
"CompletePercentage": 100,​
"ErrorInfo": "",​
"NameCN": "用户迁移",​
"ProgressType": "Account",​
"Status": "Done"​
}​
]​
}​
​
Overall progress information of the transmission task.​
​
ProgressSummaryInfo​
​
Name​
Type​
Example​
Description​
ErrorInfo​
String​
mysql endpoint error: dial tcp 172.17.****.****:3306: i/o timeout​
Task error message.​
NameCN​
String​
Incremental subscription​
The type of task progress. The values include user migration, schema migration, full migration, post-schema migration, database and table schema subscription, full subscription, incremental subscription, user synchronization, full synchronization, schema synchronization, incremental synchronization, post-schema synchronization.​
ProgressType​
String​
Incr​
Task type. The values are as follows:​
  • Account: Indicates user migration.​
  • Meta: Indicates structural migration, database and table structure subscription, or structure initialization.​
  • Full: Indicates full migration, full subscription, or full initialization.​
  • Incr: Indicates incremental migration, incremental subscription, or incremental synchronization.​
  • PostMeta: Indicates post-structural migration.​
Status​
String​
Doing​
Task status. The values are as follows:​
  • Doing: Indicates that the verification task is in progress.​
  • Todo: Indicates that the verification task is pending.​
  • Done: Indicates that the verification task is completed.​
​
Example​
Request example​
​
​
POST /?Action=DescribeTransmissionTaskInfo&Version=2022-10-01 HTTP/1.1​
Content-Type: application/json​
Host: dts.volcengineapi.com​
X-Date: 20221001T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20221001/cn-beijing/dts/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
{​
"TaskId": "c37008625ddd44019ee85b84fb*****"​
}​
​
Response example​
​
{​
"ResponseMetadata": {​
"RequestId": "20230320101845AB32F20DFC215A10B4A9",​
"Action": "DescribeTransmissionTaskInfo",​
"Version": "2022-10-01",​
"Service": "dts",​
"Region": "cn-beijing"​
},​
"Result": {​
"TaskInfo": {​
"ChargeDetail": {​
"ChargeStatus": "Init",​
"ChargeType": "PostPaid",​
"OrderNo": ""​
},​
"CreateTime": 1661242976288,​
"DestConfig": {​
"DataSourceId": "322",​
"EndpointType": "Volc_Kafka",​
"VolcKafkaSettings": {​
"AuthType": "PLAIN",​
"InstanceId": "kafka-cnngfsm7gl******",​
"InstanceName": "",​
"Password": "******",​
"RegionSettings": {​
"Region": ""​
},​
"Topic": "hua",​
"Username": "kakatest****"​
}​
},​
"EnableCloudMonitor": true,​
"EndTime": 0,​
"ProjectName": "default",​
"SolutionSettings": {​
"PG2KafkaSettings": {​
"ErrorBehaviorSettings": {​
"MaxRetrySeconds": 7200​
},​
"FullTransmissionSettings": {​
"EnableFull": false​
},​
"IncrTransmissionSettings": {​
"EnableIncr": true,​
"Statements": [​
"StmtDMLInsert",​
"StmtDMLUpdate",​
"StmtDMLDelete",​
"StmtDDLAll"​
]​
},​
"MetaTransmissionSettings": {​
"EnableMeta": false​
},​
"ObjectMappings": [​
{​
"DestObjName": "public",​
"MappingList": [​
{​
"DestObjName": "*",​
"ObjectType": "Table",​
"SrcObjName": "*"​
}​
],​
"ObjectType": "Database",​
"SrcObjName": "public"​
}​
],​
"SubscriptionSettings": {​
"PartitionPolicy": "P0",​
"Protocol": "Volc",​
"VPCId": "vpc-bp1opxu1zkhn00gz****",​
"VPCSubnetId": ""​
}​
},​
"SolutionType": "PG2Kafka"​
},​
"SrcConfig": {​
"DataSourceId": "321",​
"EndpointType": "Volc_PostgreSQL",​
"VolcPostgreSQLSettings": {​
"DBInstanceId": "postgres-338f4f3ad26a",​
"DBInstanceName": "",​
"DBName": "test****zaizai",​
"Password": "******",​
"RegionSettings": {​
"Region": "cn-beijing"​
},​
"Username": "test****zaizai"​
}​
},​
"StartTime": 1661242976288,​
"TaskId": "c37008625ddd44019ee85b84fb******",​
"TaskName": "test****zaizai",​
"TaskStatus": "Init",​
"TaskSubType": "Default",​
"TaskType": "DataSubscription",​
"TenantId": "2100157781",​
"TrafficSpec": "Compact"​
}​
}​
}​
​
Error code​
For more details, see Error code.​
Last updated: 2026.09.07 14:46:37