从 PostgreSQL 迁移至 Zilliz Cloud
本文档说明从 PostgreSQL 迁移时，Zilliz Cloud 如何处理数据类型映射、Collection 命名规则及注意事项。
开始前
开始离线迁移前需满足：
PostgreSQL 侧要求
| 要求项 | 详细说明 |
|---|---|
| 网络访问 | 源集群必须可通过公网访问 |
| 数据库权限 | 需提供有效的数据库 Endpoint、用户名及密码（具备必要权限） |
| pgvector 扩展 | 必须启用 pgvector 扩展存储向量数据 |
| 向量字段要求 | 每个源表需包含至少一个向量字段，且向量字段禁止为空值 |
| 数据可用性 | 源表必须包含数据，空表无法迁移 |
Zilliz Cloud 侧要求
| 要求项 | 详细说明 |
|---|---|
| 用户权限 | 需具备组织管理员或项目管理员角色 |
| 目标集群容量 | 需预留足够 CU 容纳源数据（使用 CU 计算器预估容量） |
| 网络连通性 | 如果有网络限制，请确保已将 Zilliz Cloud IP 加入白名单 |
数据类型映射
下表总结了 PostgreSQL 字段类型如何映射到 Zilliz Cloud 字段类型，并对各类型做了详细说明。
PostgreSQL 字段类型 | Zilliz Cloud 字段类型 | 描述 |
|---|---|---|
主键 | 主键 / Auto ID |
在数据迁移时，您可以选择启用 Auto ID 功能；但请注意，启用后源表中的原始主键值将会被舍弃。 |
vector | FLOAT_VECTOR | 向量维度保持不变。 |
text/varchar/date/time | VARCHAR | 以字符串存储。 |
bigint | INT64 | |
integer | INT32 | |
smallint | INT16 | |
double precision | DOUBLE | |
real | FLOAT | |
boolean | BOOL | |
array | ARRAY | |
json | JSON |
PostgreSQL 特殊处理规则
Collection 命名规则
PostgreSQL 索引名称将按以下规则迁移至 Zilliz Cloud：
| 场景 | 影响 | 解决方案 |
|---|---|---|
| 默认命名 | Collection 名称与源索引名称完全一致 | 保留原始名称 |
| 名称冲突 | 目标 Database 存在同名 Collection 时无法提交迁移任务 | 删除现有 Collection / 选择其他目标 Database / 迁移配置时重命名 Collection |
| 名称修改 | 迁移过程支持重命名 | 可在迁移配置阶段修改 Collection 名称 |
迁移注意事项
从 PostgreSQL 迁移时需注意以下事项：
| 限制项 | 影响 | 替代方案 |
|---|---|---|
| 动态字段转固定字段 | 无法将现有动态字段转换为固定类型 | 字段保持原始动态特性 |
| 迁移过程中添加新字段 | 仅迁移 Elasticsearch 已有字段 | 无法在迁移时新增字段 |