跳到主要内容

从腾讯云向量数据库迁移至 Zilliz Cloud

本文档说明腾讯云向量数据库迁移过程中 Zilliz Cloud 的数据类型映射规则、JSON 字段转换机制及 Collection 命名规范。

开始前​

开始离线迁移前需满足：

腾讯云侧要求​

要求项详细说明
网络访问源集群必须可通过公网访问
API 访问权限需提供有效的实例 URL 及具备必要权限的 API 密钥
数据可用性源 Collection 必须包含数据，空 Collection 无法迁移

Zilliz Cloud 侧要求​

要求项详细说明
用户权限需具备组织管理员或项目管理员角色
目标集群容量需预留足够 CU 容纳源数据（使用 CU 计算器预估容量）
网络连通性如果有网络限制，请确保已将 Zilliz Cloud IP 加入白名单

数据类型映射​

下表总结了腾讯云向量数据库字段类型如何映射到 Zilliz Cloud 字段类型，并对各类型做了详细说明。

腾讯云字段类型Zilliz Cloud 字段类型描述
主键主键腾讯云向量数据库的主键字段会自动映射为 Zilliz Cloud 中的主键。
在数据迁移时，您可以选择启用 Auto ID 功能；但请注意，启用后源 Collection 中的原始主键值将会被舍弃。
稠密向量FLOAT_VECTOR稠密向量字段会直接转换为 FLOAT_VECTOR，无需进行任何修改。
JSONDynamic field默认情况下，腾讯云向量数据库的 JSON 字段会映射为 Zilliz Cloud 中的 Dynamic Field。有关详细信息，请参阅 Dynamic Field。
在迁移数据时，如果您希望对某些动态字段使用固定数据类型并优化索引配置，建议将动态字段转换为固定字段。

JSON 字段转换说明​

说明

Zilliz Cloud 采样 100 行数据检测 JSON 数据结构，必要时可手动添加字段。

腾讯云 JSON 字段默认映射为 Zilliz Cloud 的 Dynamic Field 以实现最大灵活性，转换为固定字段可带来：

  • 强数据类型校验：强制字段类型约束

  • 优化查询性能：建立专用索引

  • 结构化数据管理：统一数据规范

腾讯云字段类型Zilliz Cloud 字段类型描述
stringVARCHAR如果 JSON 中的字段类型为 string，当转换为固定字段后，该字段将变为 VARCHAR 类型。
注意：该字段的最大长度固定为 65,535 字节且不可修改，容量计算以实际字段长度为准。
uint64INT32如果 JSON 中的字段类型为 uint64，当转换为固定字段后，该字段将变为 INT32 类型。
doubleDOUBLE如果 JSON 中的字段类型为 double，当转换为固定字段后，该字段将变为 DOUBLE 类型。
arrayARRAY如果 JSON 中的字段类型为 array，当转换为固定字段后，该字段将变为 ARRAY 类型。

转换为固定字段后，可配置以下属性：

  • Nullable：决定字段是否接受空值（默认启用），详见 Nullable 属性。

  • 默认值：设置数据缺失时的回退值，详见默认值。

  • Partition Key：可将 INT64/VARCHAR 字段指定为 Partition Key（注意：每个 Collection 支持一个 Partition Key，且该字段不可为空），详见 使用 Partition Key。

腾讯云特殊处理规则​

Collection 命名规则​

腾讯云 Collection 名称将按以下规则迁移至 Zilliz Cloud：

场景影响解决方案
默认命名目标 Collection 名称默认与源 Collection 完全一致保留原始名称
名称冲突目标 Database 存在同名 Collection 时无法提交迁移任务删除现有 Collection / 选择其他目标 Database / 迁移配置时重命名 Collection
特殊字符需符合 Zilliz Cloud 命名规范迁移前请检查 Collection 名称合法性
Ctrl I