メインコンテンツまでスキップ

Qdrant から Zilliz Cloud への移行

このトピックでは、Qdrant から移行する際に、Zilliz Cloud がデータ型マッピング、ペイロードフィールドの変換、コレクション命名規則をどのように処理するかについて説明します。

インデックス設定と移行後の手順については、External Migration Basics を参照してください。

事前準備​

Qdrant から Zilliz Cloud への移行を開始する前に、次の要件を満たしていることを確認してください。

Qdrant の要件​

要件詳細
ネットワークアクセスソースの Qdrant クラスターにパブリックインターネットからアクセスできる必要があります。
API アクセスアクセス権限を持つクラスターエンドポイントと API キー
データの可用性ソースコレクションにデータが含まれている必要があります。空のコレクションは移行できません。

Zilliz Cloud の要件​

要件詳細
ユーザーロールOrganization Owner または Project Admin
クラスター容量十分なストレージとコンピューティングリソース（CU サイズの見積もりには CU 計算ツール を使用してください）
ネットワークアクセスネットワーク制限を使用する場合は、Zilliz Cloud IP アドレス を許可リストに追加してください。

データ型マッピング​

Qdrant のデータ型が Zilliz Cloud にどのようにマッピングされるかを理解することは、移行計画を立てるうえで重要です。

Qdrant のフィールド型Zilliz Cloud のフィールド型注記
プライマリキーVARCHAR（プライマリキー）自動的にマッピングされます。新しい ID を生成するには Auto ID を有効にしてください（元の値は破棄されます）。
密ベクトルFLOAT_VECTOR次元は正確に保持され、変更は不要です
スパースベクトルSPARSE_FLOAT_VECTORサンプルデータ内で空でない場合にのみマッピングされます。
ペイロードJSON（動的フィールド）デフォルトでは動的スキーマとしてマッピングされます。固定フィールドに変換できます。
詳細は Dynamic Field を参照してください。

ペイロードフィールドの変換​

Notes

Zilliz Cloud は、ペイロードスキーマを検出するために 100 行をサンプリングします。必要に応じて、追加のフィールドを手動で追加できます。

Qdrant のペイロードは、柔軟性を最大限に確保するため、最初は Zilliz Cloud の動的スキーマにマッピングされます。必要に応じて、ペイロードフィールドを固定フィールドに変換すると、次の利点が得られます。

  • データ型が強制されるため、より強力な検証が可能になります

  • インデックスが最適化されるため、クエリパフォーマンスが向上します

  • スキーマが構造化されるため、一貫したデータ管理が可能になります

ペイロードを固定フィールドに変換する場合:

Qdrant のペイロード型Zilliz の固定フィールド型注記
整数INT64型が直接変換されます。
浮動小数点DOUBLEすべての浮動小数点数が DOUBLE になります。
真偽値BOOL直接マッピングされます。
キーワードVARCHAR最大 65,535 バイトをサポートします。
地理情報JSONJSON 構造として保持されます。固定フィールドには変換できません。
日時VARCHAR最大 65,535 バイトをサポートします。
UUIDVARCHAR最大 65,535 バイトをサポートします。

配列型のサポート​

既存のペイロードデータでは配列型は検出されず、動的フィールドから変換することはできません。ただし、ほとんどの配列型は、移行設定中に新しいフィールドとして手動で追加できます。

Qdrant の配列型Zilliz Cloud の配列型手動追加の可否
Array<Integer>ARRAY<INT64> 新しいフィールドとして追加できます
Array<Float>ARRAY<DOUBLE> 新しいフィールドとして追加できます
Array<Bool>ARRAY<BOOL> 新しいフィールドとして追加できます
Array<Keyword>ARRAY<VARCHAR> 新しいフィールドとして追加できます
Array<Geo>サポートされていません 利用できません
Array<Datetime>ARRAY<VARCHAR> 新しいフィールドとして追加できます
Array<UUID>ARRAY<VARCHAR> 新しいフィールドとして追加できます

固定フィールドに変換されたペイロードフィールドでは、次の追加属性を設定できます。

  • Nullable: フィールドが null 値を受け入れられるかどうかを指定します。この機能はデフォルトで有効になっています。詳細は、Nullable attribute を参照してください。

  • Default Value: データが欠損している場合に使用するフォールバック値を設定します。詳細は、Default values を参照してください。

  • Partition Key: オプションで、INT64 または VARCHAR フィールドをパーティションキーとして指定できます。各コレクションがサポートするパーティションキーは 1 つのみで、選択したフィールドを Nullable にすることはできません。詳細は、Use Partition Key を参照してください。

Qdrant 固有の処理ルール​

コレクション命名規則​

Qdrant のコレクション名は、次の点に注意して Zilliz Cloud に引き継がれます。

シナリオ影響解決策
名前の競合データベースに同じ名前のコレクションがすでに存在する場合、移行ジョブを送信できません既存のコレクションを削除するか、別のターゲットデータベースを選択するか、移行設定中に名前を変更してください
特殊文字コレクション名は Qdrant からそのまま保持されますコレクション名が Zilliz Cloud の命名規則に準拠していることを確認してください
このページは役に立ちましたか？
Ctrl I