Qdrant から Zilliz Cloud への移行
このトピックでは、Qdrant からの移行時に Zilliz Cloud が Qdrant のデータ型マッピング、ペイロードフィールドの変換、およびコレクション命名規則をどのように処理するかについて説明します。
前提条件
Qdrant から Zilliz Cloud への移行を開始する前に、以下の要件を満たしていることを確認してください。
Qdrant の要件
Requirement | Details |
|---|---|
ネットワーク access | Source Qdrant cluster must be accessible from the public internet |
API access | Cluster endpoint and API key with access permissions |
データ availability | Source collections must contain data. Empty collections cannot be migrated. |
Zilliz Cloud の要件
Requirement | Details |
|---|---|
User role | 組織オーナー or プロジェクト管理者 |
Cluster capacity | Sufficient storage and compute resources (use the CU calculator to estimate CU size) |
ネットワーク access | Add Zilliz Cloud IPs to allowlists if using network restrictions |
データ型マッピング
Qdrant のデータ型が Zilliz Cloud にどのようにマッピングされるかを理解することは、移行の計画に不可欠です。
Qdrant Field Type | Zilliz Cloud Field Type | Notes |
|---|---|---|
Primary key | VARCHAR (primary key) | Automatically mapped. Enable 自動ID to generate new IDs (original values will be discarded). |
Dense vector | FLOAT_VECTOR | Dimensions preserved exactly, no modifications needed |
Sparse vector | SPARSE_FLOAT_VECTOR | Only mapped if non-empty in sample data. |
Payload | JSON (dynamic fields) | Mapped as dynamic schema by default; can be converted to fixed fields. Refer to Dynamic Field for more details. |
ペイロードフィールドの変換
Zilliz Cloud samples 100 rows to detect payload schema. You can manually add additional fields if needed.
Qdrant のペイロードは、最大限の柔軟性を得るために、最初は Zilliz Cloud のダイナミックスキーマにマッピングされます。ペイロードフィールドを固定フィールドに変換することで、以下のメリットを得ることができます。
-
強力な検証のためのデータ型の強制
-
クエリパフォーマンス向上のための最適化されたインデックス作成
-
一貫したデータ管理のための構造化スキーマ
ペイロードを固定フィールドに変換する場合：
Qdrant Payload Type | Zilliz Fixed Field Type | Notes |
|---|---|---|
Integer | INT64 | Direct type conversion |
Float | DOUBLE | All float numbers become DOUBLE |
Bool | BOOL | Direct mapping |
キーword | VARCHAR | Maximum 65,535 bytes supported |
Geo | JSON | Preserved as JSON structure; cannot convert to fixed fields |
Datetime | VARCHAR | Maximum 65,535 bytes supported |
UUID | VARCHAR | Maximum 65,535 bytes supported |
配列型のサポート
配列型は既存のペイロードデータでは検出されず、ダイナミックフィールドから変換することもできません。ただし、移行設定時にほとんどの配列型を新しいフィールドとして手動で追加できます。
Qdrant 配列 Type | Zilliz Cloud 配列 Type | Available for Manual Addition |
|---|---|---|
配列<Integer> | ARRAY<INT64> | ✅ Can be added as new field |
配列<Float> | ARRAY<DOUBLE> | ✅ Can be added as new field |
配列<Bool> | ARRAY<BOOL> | ✅ Can be added as new field |
配列<キーword> | ARRAY<VARCHAR> | ✅ Can be added as new field |
配列<Geo> | Not supported | ❌ Not available |
配列<Datetime> | ARRAY<VARCHAR> | ✅ Can be added as new field |
配列<UUID> | ARRAY<VARCHAR> | ✅ Can be added as new field |
固定フィールドに変換されたペイロードフィールドについては、以下の追加属性を設定できます。
-
NULL許容: フィールドが null 値を受け入れるかどうかを決定します。この機能はデフォルトで有効になっています。詳細については、NULL許容 属性 を参照してください。
-
デフォルト値: データが欠損している場合のフォールバック値を設定します。詳細については、デフォルト値 を参照してください。
-
パーティションキー: オプションで、INT64 または VARCHAR フィールドをパーティションキーとして指定できます。各コレクションは1つのパーティションキーのみをサポートし、選択したフィールドは NULL 許容にできないことに注意してください。詳細については、パーティションキーの使用 を参照してください。
Qdrant 固有の処理ルール
コレクション命名規則
Qdrant のコレクション名は、以下の考慮事項に基づいて Zilliz Cloud に転送されます。
Scenario | Impact | ソリューション |
|---|---|---|
名前の競合 | Cannot submit a migration job if a collection with the same name already exists in the database | Delete existing collection, choose a different target database, or rename during migration configuration |
Special characters | Collection names are preserved as-is from Qdrant | Ensure collection names comply with Zilliz Cloud naming conventions |