调用ImportDatabaseBetweenInstances接口从其它RDS实例迁入数据。
建议您使用数据传输服务DTS,集数据迁移、订阅、同步于一体,为您提供稳定安全的传输链路。更多信息,请参见DTS API概览。
迁移过程中,源实例的状态处于迁移中,目标实例的状态处于数据导入中。
调用该接口时,实例必须满足以下条件,否则将操作失败:
- 仅支持SQL Server的独享和独占规格的实例,关于实例规格详情,请参见实例规格表;
- 仅适用于不同实例间(实例都属于同一个用户)的数据库迁移;
- 实例状态为运行中;
- 数据库状态为运行中;
- 确保目标实例的剩余存储空间>源实例数据库的存储空间;
说明
- 暂不支持SQL Server 2017集群版实例。
- 支持批量数据库迁入。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ImportDatabaseBetweenInstances | 系统规定参数,取值:ImportDatabaseBetweenInstances。 |
DBInfo | String | 是 | {“DBNames”:[“mydb”,”mydb2”]} | 待迁移实例的数据库信息,格式为JSON串。
说明 对于SQL Server实例,值为key-value对,key为原数据库,value为迁移目标数据库,SQL Server允许源数据库和目标数据库名称可以不一致。例如:
{“DBNames”:{“srcdb”:”destdb”,”srcdb2”:”destmydb2”}}表示将srcdb迁入至destdb,将srcdb2迁入至destmydb2,但是多个源数据库名称不允许一样,多个目标数据库名称也不允许一样。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx | 目标实例ID。 |
SourceDBInstanceId | String | 是 | rm-g4a1jk8xxxxxxx | 源实例ID,不能与目标实例相同。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ImportId | String | 85265475235 | 导入任务的ID。 |
RequestId | String | 5A77D650-27A1-4E08-AD9E-59008EDB6927 | 请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=ImportDatabaseBetweenInstances &DBInstanceId=rm-uf6wjk5xxxxxxx &SourceDBInstanceId=rm-g4a1jk8xxxxxxx &DBInfo={“DBNames”:[“mydb”,”mydb2”]} &<公共请求参数>
正常返回示例
XML
格式
<ImportDatabaseBetweenInstancesResponse> <ImportId>2122321</ImportId> <RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId> </ImportDatabaseBetweenInstancesResponse>
JSON
格式
{ "ImportId":2122321, "RequestId":"5A77D650-27A1-4E08-AD9E-59008EDB6927" }
错误码
访问错误中心查看更多错误码。