Pinecone から Zilliz Cloud への移行

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

前提条件

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

要件	詳細
Index type	Pinecone Serverless index からの移行のみをサポート
API access	アクセス権限を持つ Pinecone API key
Data availability	Pinecone のソース index にはデータが含まれている必要があります。空の index は移行できません。
Vector dimension	次元は 1 より大きい必要があります。単一次元 vector は移行失敗の原因になります

要件	詳細
User role	Organization Owner または Project Admin
Cluster capacity	十分なストレージおよびコンピューティングリソース（CU サイズの見積もりには CU calculator を使用）
Network access	ネットワーク制限を使用している場合は、Zilliz Cloud IPs を許可リストに追加

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

Pinecone フィールド型	Zilliz Cloud フィールド型	Notes
Primary key	VARCHAR (primary key)	自動的にマッピングされます。新しい ID を生成するには Auto ID を有効にします（元の値は破棄されます）。
Dense vector	FLOAT_VECTOR	次元は正確に保持され、変更は不要です
Sparse vector	SPARSE_FLOAT_VECTOR	サンプルデータ内で空でない場合にのみマッピングされます。
Metadata	Dynamic fields	デフォルトで dynamic schema としてマッピングされます。fixed fields に変換することもできます。詳細は Dynamic Field を参照してください。
Namespace	Partition key / partition	パフォーマンス最適化のために推奨されます。詳細は Namespace processing を参照してください。

📘Notes

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

Pinecone metadata は、最大限の柔軟性を得るために、最初は Zilliz Cloud の dynamic schema にマッピングされます。必要に応じて metadata フィールドを fixed fields に変換することで、次の利点が得られます。

metadata を fixed fields に変換する場合:

fixed fields に変換された metadata フィールドについては、追加の属性を設定できます。

Nullable: フィールドが null 値を受け入れられるかどうかを決定します。この機能はデフォルトで有効です。詳細は Nullable attribute を参照してください。
Default Value: データが存在しない場合のフォールバック値を設定します。詳細は Default values を参照してください。

Pinecone namespace は、次の 2 つの戦略で移行できます。

Strategy	Implementation	Performance Impact	Use Case
Namespace as Partition Key (推奨)	namespace は partition key フィールド内の値になります	検索パフォーマンスのための自動最適化	複数の namespace を持つほとんどのシナリオ
Namespace as Partition	各 namespace は個別の partition になります	手動の partition 管理が必要	namespace が少なく安定しているシンプルなシナリオ

📘Notes

Pinecone の default namespace の処理:

partition および partition key の概念の詳細については、Manage Partitions および Use Partition Key を参照してください。

Pinecone index 名は、Zilliz Cloud との互換性のために自動的に処理されます。

Pinecone Index Name	Zilliz Cloud Collection Name	Rule Applied
`my-vector-index`	`my_vector_index`	Zilliz Cloud の collection 命名規則に準拠するため、ハイフン (`-`) はアンダースコア (`_`) に変換されます
`product_search`	`product_search`	変更は不要

命名の競合: ターゲット database に同じ名前の collection がすでに存在する場合は、次のいずれかを行う必要があります。