从 Qdrant 迁移至 Zilliz Cloud

Qdrant 是一款提供相似性搜索功能的向量数据库。将数据从 Qdrant 迁移到 Zilliz Cloud，用户可以在保持 Qdrant 支持的多向量结构兼容性的同时，利用 Zilliz Cloud 的高级搜索和分析功能。

本指南将引导您完成整个迁移过程，包括连接 Qdrant、配置数据映射，以及排查潜在问题。

注意事项

• 从 Qdrant 迁移到 Zilliz Cloud 时，向量字段会直接迁移，而 Qdrant 的 payload 数据会以 JSON 格式存储在 Zilliz Cloud 的动态字段中。有关动态字段功能的详细信息，请参阅开启动态字段。

• 不支持迁移包含空值的 payload 数据。若有空值，请先移除相应字段。

• 为确保兼容性，目标 Collection 中的 Auto ID 将被禁用，且无法修改。

• 每个迁移任务仅限一个源 Qdrant 集群。如有多个源集群数据，可启用多个迁移任务。

开始前

• 源 Qdrant 集群必须能够通过公网访问。

• 已获取访问目标 Qdrant 集群所需的集群 Endpoint 和 API 密钥，并具有相应权限。

• 已在 Zilliz Cloud 中获得组织管理员或项目管理员权限。如果您没有相关权限，请联系您的 Zilliz Cloud 管理员。

从 Qdrant 迁移至 Zilliz Cloud

您可以将源数据迁移到任何版本类型的 Zilliz Cloud 集群，只要其计算单元（CU）大小能够满足源数据的存储需求。

1. 登录 Zilliz Cloud 控制台。

2. 进入目标项目，选择数据迁移 > Qdrant。

3. 在连接数据源步骤中，输入集群 Endpoint 和 API Key，然后点击下一步。

   📘说明

   Database Authentication 可以指导您如何获取所需的连接信息。

4. 在选择迁移来源和目标步骤中，配置源 Qdrant 集群 和 Zilliz Cloud 集群设置，点击下一步。

   📘说明

   每个从 Qdrant 集群迁移的源 Collection 必须包含一个或多个向量字段。

5. 在配置 Schema 步骤中：

   1. 在 Schema 预览中，确认 Qdrant Collection 与 Zilliz Cloud Collection 之间的字段映射。

      📘说明

      • Auto ID 禁用且无法修改。

      • 您可以重命名字段，但不支持修改字段的数据类型。

   2. 在高级设置中，确认动态列和 Partition Key 的设置：

      • 动态列：默认启用且不可修改。它用于存储源 Collection 的 payload 数据。

      • Partition Key：默认禁用且不可修改。由于 Qdrant 的 payload 数据以 JSON 形式存储在动态列中，无法作为 Partition Key 使用。在 Zilliz Cloud 中，只有在 Schema 中明确定义的标量字段可用作 Partition Key。

   3. 在目标 Collection 名称和描述中，自定义目标 Collection 的名称和描述。Collection 名称在每个集群中必须唯一。如果名称与现有 Collection 重复，请重命名 Collection。

6. 点击迁移。

查看迁移进度

生成迁移任务后，您可前往任务中心查看任务状态和进度。如果迁移任务的状态从进行中变更为成功，则代表迁移成功。

📘说明

迁移完成后，请验证目标集群中的 collection 和 entity 数量是否与数据源一致。如果发现不一致，请删除缺失 entity 的 collection 并重新进行迁移。

取消迁移任务

如果迁移过程遇到任何问题，您可以采取以下步骤进行故障排除并恢复迁移：

1. 在任务中心页面，取消失败的迁移任务。

2. 在操作列点击查看详情以访问日志信息。