迁移

迁移 用于将 Apache Doris、SelectDB Enterprise 或 Starrocks 中所选数据库和表的数据迁入 SelectDB Cloud。当前 Starrocks 入口标记为 BETA，使用前应验证源端版本、表结构和业务兼容性。

准备工作

1. 登录 SelectDB Cloud 控制台，选择目标仓库，单击左侧导航栏的 迁移。
2. 准备源集群的主机地址、JDBC 端口、HTTP 端口及数据库凭证，确保任务可以访问源端。
3. 准备用于中转数据的对象存储 Bucket、Endpoint、区域及授权信息，确保源端和迁移任务能访问该存储。
4. 确认目标仓库具有可用计算集群，以及足够的存储和操作权限。

首次进入时，直接选择源端类型；已有任务时，单击 新建迁移任务，再选择 Apache Doris、SelectDB Enterprise 或 Starrocks。

1. 连接源集群

在 源端数据连接 中填写：

配置项	说明
任务名称、备注	使用便于识别来源和用途的名称，按需填写备注。
主机地址	源集群的可访问地址，不包含 JDBC URL 路径。
JDBC 端口、HTTP 端口	分别填写源端实际提供的端口，不要将两个端口混用。
用户名、密码	使用具有所需元数据读取和数据迁移权限的源端数据库用户。
反向私有端点	源端位于私网且环境支持时，配置对应私网连接。
SSH 隧道	需要经过跳板机访问时配置 SSH 连接和认证信息。

单击 下一步 校验连接。失败时，检查主机、端口、源端访问控制及凭证，再重新校验。

2. 配置临时对象存储

在 临时对象存储 中选择 云服务商，填写 Endpoint、区域、Bucket 名称 和认证信息。页面按所选服务商展示相应的配置与认证方式。

• Endpoint 与区域必须对应实际 Bucket，不要直接复制其他地域的示例。
• 源端导出和目标端读取需要能够访问同一中转存储，且授权覆盖任务使用的对象路径。
• 中转过程涉及对象写入、读取和临时数据清理，应提供相应权限，并考虑存储及流量费用。

使用专用 Bucket 或专用中转路径，避免与业务文件混用。任务结束或失败后，核对清理结果及残留对象，再决定是否清理；不要仅因任务结束就删除整个业务 Bucket。

3. 选择数据库和表

1. 在 表配置 中选择需要迁移的数据库和表，可以批量选择，也可以按名称筛选。
2. 核对源库表与目标库表的映射，检查目标是否已有同名对象。
3. 需要只迁移部分数据时，在对应表的 条件 中填写行过滤条件，并核对其字段和语义。
4. 确认迁移范围后，单击 下一步。

迁移只覆盖所选对象和条件范围，不应将其视为包含用户、权限及所有集群配置的完整备份。

4. 设置迁移资源

在 参数设置 中选择执行任务的 集群，配置并发：

配置项	说明
表级并发	同时迁移的表数量，默认 5，最小值为 1。
表内并发	单张表迁移时的 Tablet 并发度，默认 1，最小值为 1。

提高并发可能缩短迁移时间，也会增加源集群、目标集群、网络和对象存储的压力。应先评估业务负载，再逐步调整。

5. 预检查并启动

1. 在 校验并确认 中查看检查项、结果及说明，修复连接、权限或配置问题。
2. 需要重新检查时，单击 重新检查。
3. 如果页面提供预计耗时，结合数据量、表数和并发核对。估算受源端负载、网络和对象存储性能影响，不是完成时间承诺。
4. 检查通过并确认范围后，单击 开始。

启动会实际读取源数据、写入临时对象并向目标仓库导入。迁移过程中源端继续写入时，应另行规划数据一致性校验和切换窗口，不能将一次迁移当作持续增量同步。

监控迁移任务

在迁移任务列表中查看名称、来源、状态和创建时间。单击任务名称，查看整体进度、库表迁移状态、已迁移数据及错误信息。

• 任务失败时，根据具体表和错误定位源端连接、对象存储权限、目标表兼容性或资源问题。
• 需要暂停、恢复或编辑时，使用任务状态允许的操作。编辑后如提供 仅保存 和 保存并恢复，按是否立即继续运行选择。
• 删除任务前核对页面说明；删除任务记录不等同于回滚已经写入目标仓库的数据。

任务成功后，核对目标表结构、行数和关键业务查询；支持 查看报告 的任务还可以查看表迁移结果及上下游对比。源端仍在变化时，不同采集时间的行数或字节数可能不同，应结合业务口径判断。