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

Pinecone から Zilliz Cloud への移行

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

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

事前準備​

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

Pinecone の要件​

要件詳細
インデックスタイプPinecone Serverless インデックスからの移行のみをサポートします。
API アクセスアクセス権限のある Pinecone API キー
データの可用性Pinecone のソースインデックスにはデータが含まれている必要があります。空のインデックスは移行できません。
ベクトル次元次元は 1 より大きい必要があります。単一次元のベクトルは移行失敗の原因になります。

Zilliz Cloud の要件​

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

データ型マッピング​

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

Pinecone のフィールド型Zilliz Cloud のフィールド型備考
プライマリキーVARCHAR（プライマリキー）自動的にマッピングされます。新しい ID を生成するには Auto ID を有効にします（元の値は破棄されます）。
密ベクトルFLOAT_VECTOR次元は正確に保持され、変更は不要です。
スパースベクトルSPARSE_FLOAT_VECTORサンプルデータ内で空でない場合にのみマッピングされます。
メタデータ動的フィールドデフォルトでは動的スキーマとしてマッピングされます。固定フィールドに変換できます。
詳細については、動的フィールド を参照してください。
Namespaceパーティションキー / パーティションパフォーマンス最適化のために推奨されます。
詳細については、Namespace の処理 を参照してください。

メタデータフィールドの変換​

Notes

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

Pinecone のメタデータは、最大限の柔軟性を実現するために、最初は Zilliz Cloud の動的スキーマにマッピングされます。任意でメタデータフィールドを固定フィールドに変換すると、次のメリットを得られます。

  • より厳密な検証を実現するデータ型の適用

  • クエリパフォーマンスを向上させるインデックスの最適化

  • 一貫したデータ管理を実現する構造化スキーマ

メタデータを固定フィールドに変換すると、次のようにマッピングされます。

Pinecone のメタデータ型Zilliz の固定フィールド型備考
文字列VARCHAR最大 65,535 バイトをサポートします。
数値 (int/float)DOUBLEすべての数値型は DOUBLE になります。
ブール値BOOL直接マッピングされます。
文字列のリストARRAY<VARCHAR>ネストされた配列をサポートします。

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

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

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

Pinecone 固有の処理ルール​

Namespace の処理​

Pinecone の Namespace は、次の 2 つの戦略を使用して移行できます。

戦略実装パフォーマンスへの影響ユースケース
Namespace をパーティションキーとして使用 （推奨）Namespace がパーティションキーフィールドの値になります検索パフォーマンスの自動最適化複数の Namespace があるほとんどのシナリオ
Namespace をパーティションとして使用各 Namespace が個別のパーティションになります手動でのパーティション管理が必要ですNamespace が少なく安定しているシンプルなシナリオ
Notes

Pinecone の default Namespace は次のように処理されます。

  • パーティションとして: Zilliz Cloud では _default パーティションになります。

  • パーティションキーとして: 空の文字列 "" になります。

パーティションとパーティションキーの概念の詳細については、パーティションの管理 および パーティションキーの使用 を参照してください。

コレクションの命名規則​

Pinecone のインデックス名は、Zilliz Cloud との互換性のために自動的に処理されます。

Pinecone のインデックス名Zilliz Cloud のコレクション名適用されるルール
my-vector-indexmy_vector_indexZilliz Cloud のコレクション命名規則に準拠するため、ハイフン（-）はアンダースコア（_）に変換されます。
product_searchproduct_search変更は不要です。

命名の競合: ターゲットデータベースに同じ名前のコレクションがすでに存在する場合は、次のいずれかを行う必要があります。

  • 既存のコレクションを削除します。または

  • 別のターゲットデータベースを選択します。または

  • 移行の設定中にターゲットコレクションの名前を変更します。

このページは役に立ちましたか？
Ctrl I