从 OpenSearch 迁移至 Zilliz Cloud
本文档说明从 OpenSearch 迁移时，Zilliz Cloud 如何处理数据类型映射、Collection 命名规则及注意事项。
开始前
开始离线迁移前需满足：
OpenSearch 侧要求
| 要求项 | 详细说明 |
|---|---|
| 网络访问 | 源集群必须可通过公网访问 |
| 认证权限 | 需提供有效的集群 Endpoint、用户名及密码（具备必要权限） |
| 向量字段要求 | 每个源索引必须包含至少一个 k-NN 向量字段 |
| 数据可用性 | 源索引必须包含数据，空索引无法迁移 |
Zilliz Cloud 侧要求
| 要求项 | 详细说明 |
|---|---|
| 用户权限 | 需具备组织管理员或项目管理员角色 |
| 目标集群容量 | 需预留足够 CU 容纳源数据（使用 CU 计算器预估容量） |
| 网络连通性 | 如果有网络限制，请确保已将 Zilliz Cloud IP 加入白名单 |
数据类型映射
下表总结了 OpenSearch 字段类型如何映射到 Zilliz Cloud 字段类型，并对各类型做了详细说明。
| OpenSearch 字段类型 | Zilliz Cloud 字段类型 | 描述 |
|---|---|---|
| 主键（_id） | 主键 | OpenSearch 的 ID 字段将自动映射为 Zilliz Cloud 的主键字段。 |
| k-NN vector | FLOAT_VECTOR | OpenSearch 中的 float 向量类型映射到 Zilliz Cloud 上的 FLOAT_VECTOR。OpenSearch 的 Byte/Binary 向量不支持迁移。向量维度保持不变。 |
| Alias | Not supported | 暂不支持映射该字段。 |
| Binary | VARCHAR | Binary 数据在 Zilliz Cloud 中以字符串形式存储。 |
| Numeric | ||
byte | INT8 | 直接映射。 |
double | DOUBLE | 直接映射。 |
float | FLOAT | 直接映射。 |
half_float | FLOAT | 映射为 FLOAT 数据类型。 |
integer | INT32 | 直接映射。 |
long | INT64 | 直接映射。 |
short | INT16 | 直接映射。 |
unsigned_long | 不支持 | 暂不支持映射该字段。 |
scaled_float | 不支持 | 暂不支持映射该字段。 |
| Boolean | BOOL | 存储 true 或 false。 |
| Date | VARCHAR | 存储为字符串。 |
| IP address | VARCHAR | 存储为字符串。 |
| Range | JSON | 序列化为 JSON 格式。 |
| Object | ||
object | JSON | 序列化为 JSON 格式。 |
nested | JSON | 序列化为 JSON 格式。 |
flat_object | JSON | 序列化为 JSON 格式。 |
join | VARCHAR | 存储为字符串。 |
| String | ||
keyword | VARCHAR | 存储为字符串。 |
text | VARCHAR | 映射到 Milvus 2.5 或更早版本中的 VARCHAR。 |
match_only_text | VARCHAR | 存储为字符串。 |
token_count | INT32 | 存储为 INT32。 |
wildcard | 不支持 | 暂不支持映射该字段。 |
| Autocomplete | VARCHAR | 存储为字符串。 |
| Geographic | VARCHAR | 存储为字符串。 |
| Rank | VARCHAR | 存储为字符串。 |
| Percolator | VARCHAR | 存储为字符串。 |
| Derived | 不支持 | 暂不支持映射该字段。 |
| Star-tree | 不支持 | 暂不支持映射该字段。 |
| Arrays | 不支持 | 暂不支持映射该字段。 |
| Multifields | 不支持 | 暂不支持映射该字段。 |
OpenSearch 特殊处理规则
Collection 命名规则
OpenSearch 索引名称将按以下规则迁移至 Zilliz Cloud：
| 场景 | 影响 | 解决方案 |
|---|---|---|
| 默认命名 | Collection 名称与源索引名称完全一致 | 保留原始名称 |
| 特殊字符 | 含连字符(-)或点号(.)的索引名称将导致迁移任务提交失败 | 手动重命名目标 Collection（使用下划线等合法字符） |
| 名称冲突 | 目标 Database 存在同名 Collection 时无法提交迁移任务 | 删除现有 Collection / 选择其他目标 Database / 迁移配置时重命名 Collection |
迁移注意事项
从 OpenSearch 迁移时需注意以下事项：
| 限制项 | 影响 | 替代方案 |
|---|---|---|
| 动态字段转固定字段 | 无法将现有动态字段转换为固定类型 | 字段保持原始动态特性 |
| 迁移过程中添加新字段 | 仅迁移 Elasticsearch 已有字段 | 无法在迁移时新增字段 |
| 稀疏向量迁移 | 当前版本不支持迁移稀疏向量 | 考虑使用稠密向量替代方案，或联系支持团队了解路线图 |