Qdrant から Zilliz Cloud への移行
このトピックでは、Qdrant から移行する際に、Zilliz Cloud がデータ型のマッピング、ペイロードフィールドの変換、およびコレクション命名規則をどのように処理するかについて説明します。
前提条件
Qdrant から Zilliz Cloud への移行を開始する前に、以下の要件を満たしていることを確認してください。
Qdrant の要件
要件 | 詳細 |
|---|---|
ネットワークアクセス | ソース Qdrant クラスターはパブリックインターネットからアクセス可能である必要があります |
API アクセス | アクセス権限を持つクラスターエンドポイントと API キー |
データの可用性 | ソースコレクションにはデータが含まれている必要があります。空のコレクションは移行できません。 |
Zilliz Cloud の要件
要件 | 詳細 |
|---|---|
ユーザーロール | 組織オーナーまたはプロジェクト管理者 |
クラスター容量 | 十分なストレージおよびコンピューティングリソース（CU サイズの見積もりにはCU 計算機を使用してください） |
ネットワークアクセス | ネットワーク制限を使用している場合は、Zilliz Cloud IPsを許可リストに追加してください |
データ型のマッピング
Qdrant のデータ型が Zilliz Cloud にどのようにマッピングされるかを理解することは、移行計画において重要です。
Qdrant フィールド型 | Zilliz Cloud フィールド型 | 注記 |
|---|---|---|
主キー | VARCHAR (主キー) | 自動的にマッピングされます。新しい ID を生成するには自動 ID を有効にしてください（元の値は破棄されます）。 |
密ベクトル | FLOAT_VECTOR | 次元数はそのまま保持され、変更は不要です |
疎ベクトル | SPARSE_FLOAT_VECTOR | サンプルデータで空でない場合にのみマッピングされます。 |
ペイロード | JSON (動的フィールド) | デフォルトでは動的スキーマとしてマッピングされます。固定フィールドに変換することも可能です。 詳細については、動的フィールドを参照してください。 |
ペイロードフィールドの変換
Zilliz Cloud はペイロードスキーマを検出するために 100 行をサンプリングします。必要に応じて手動で追加のフィールドを追加できます。
Qdrant のペイロードは、最大限の柔軟性のために当初 Zilliz Cloud の動的スキーマにマッピングされます。オプションでペイロードフィールドを固定フィールドに変換することで、以下のような利点を得られます。
- より強力な検証のためのデータ型の強制
- より良いクエリパフォーマンスのための最適化されたインデックス
- 一貫したデータ管理のための構造化されたスキーマ
ペイロードを固定フィールドに変換する場合：
Qdrant ペイロード型 | Zilliz 固定フィールド型 | 注記 |
|---|---|---|
Integer | INT64 | 直接的な型変換 |
Float | DOUBLE | すべての浮動小数点数は DOUBLE になります |
Bool | BOOL | 直接的なマッピング |
キーword | VARCHAR | 最大 65,535 バイトまでサポート |
Geo | JSON | JSON 構造として保持されます。固定フィールドに変換することはできません |
Datetime | VARCHAR | 最大 65,535 バイトまでサポート |
UUID | VARCHAR | 最大 65,535 バイトまでサポート |
配列型のサポート
既存のペイロードデータでは配列型は検出されず、動的フィールドから変換することはできません。ただし、ほとんどの配列型は移行設定中に新しいフィールドとして手動で追加できます。
Qdrant 配列型 | Zilliz Cloud 配列型 | 手動追加の可否 |
|---|---|---|
配列<Integer> | ARRAY<INT64> | ✅ 新しいフィールドとして追加可能 |
配列<Float> | ARRAY<DOUBLE> | ✅ 新しいフィールドとして追加可能 |
配列<Bool> | ARRAY<BOOL> | ✅ 新しいフィールドとして追加可能 |
配列<キーword> | ARRAY<VARCHAR> | ✅ 新しいフィールドとして追加可能 |
配列<Geo> | 非サポート | ❌ 利用不可 |
配列<Datetime> | ARRAY<VARCHAR> | ✅ 新しいフィールドとして追加可能 |
配列<UUID> | ARRAY<VARCHAR> | ✅ 新しいフィールドとして追加可能 |
固定フィールドに変換されたペイロードフィールドについては、追加の属性を設定できます。
-
NULL 許容: フィールドが null 値を受け入れられるかどうかを決定します。この機能はデフォルトで有効です。詳細については、NULL 許容属性 を参照してください。
-
デフォルト値: データが欠落している場合のフォールバック値を設定します。詳細については、デフォルト値 を参照してください。
-
パーティションキー: オプションで INT64 または VARCHAR フィールドをパーティションキーとして指定できます。各コレクションは 1 つのパーティションキーのみをサポートしており、選択されたフィールドは NULL 許容であってはならないことに注意してください。詳細については、パーティションキーの使用 を参照してください。
Qdrant 固有の処理規則
コレクション命名規則
Qdrant のコレクション名は、以下の考慮事項を踏まえて Zilliz Cloud に転送されます。
シナリオ | 影響 | ソリューション |
|---|---|---|
名前の競合 | データベース内に同じ名前のコレクションが既に存在する場合、移行ジョブを送信できません | 既存のコレクションを削除する、異なるターゲットデータベースを選択する、または移行設定中に名前を変更する |
特殊文字 | コレクション名は Qdrant からそのまま保持されます | コレクション名が Zilliz Cloud の命名規則に準拠していることを確認してください |