Tencent Cloud から Zilliz Cloud への移行
このトピックでは、Zilliz Cloud が Tencent Cloud VectorDB からの移行時に、データ型のマッピング、JSON フィールドの変換、およびコレクションの命名規則をどのように処理するかについて説明します。
前提条件
Tencent Cloud VectorDB から Zilliz Cloud への移行を開始する前に、以下の要件を満たしていることを確認してください。
Tencent Cloud VectorDB の要件
要件 | 詳細 |
|---|---|
ネットワークアクセス | ソースの VectorDB インスタンスはパブリックインターネットからアクセス可能である必要があります |
API アクセス | 必要な権限を持つ有効なインスタンス URL と API キー |
データの可用性 | ソースのコレクションにはデータが含まれている必要があります。空のコレクションは移行できません。 |
Zilliz Cloud の要件
要件 | 詳細 |
|---|---|
ユーザーロール | 組織オーナーまたはプロジェクト管理者 |
クラスター容量 | 十分なストレージとコンピューティングリソース（CU 計算ツールを使用して CU サイズを見積もってください） |
ネットワークアクセス | ネットワーク制限を使用している場合は、Zilliz Cloud IP を許可リストに追加してください |
データ型のマッピング
Tencent Cloud VectorDB のデータ型が Zilliz Cloud にどのようにマッピングされるかを理解することは、移行の計画に不可欠です。
VectorDB フィールド型 | Zilliz Cloud フィールド型 | 説明 |
|---|---|---|
プライマリキー | VARCHAR (プライマリキー) | Tencent Cloud VectorDB のプライマリキーは、Zilliz Cloud のプライマリキーとして自動的にマッピングされます。 データの移行時に自動IDを有効にすることができます。ただし、有効にした場合、ソースコレクションの元のプライマリキー値は破棄されます。 |
デンスベクトル | FLOAT_VECTOR | デンスベクトルフィールドは、変更を加えることなく FLOAT_VECTOR として転送されます。 |
JSON | JSON (動的フィールド) | デフォルトで動的スキーマとしてマッピングされます。固定フィールドに変換することもできます。 詳細については、動的フィールドを参照してください。 |
JSON フィールドの変換
Zilliz Cloud は JSON スキーマを検出するために 100 行をサンプリングします。必要に応じて、手動で追加のフィールドを追加できます。
Tencent Cloud VectorDB の JSON フィールドは、最大限の柔軟性を得るために、最初は Zilliz Cloud の動的スキーマにマッピングされます。JSON フィールドを固定フィールドに変換することで、以下のメリットを得ることができます。
-
より強力な検証のための厳格なデータ型の適用
-
より優れたクエリパフォーマンスのための最適化されたインデックス作成
-
一貫したデータ管理のための構造化されたスキーマ
以下の JSON フィールド型は、動的フィールドから固定フィールドに自動的に変換できます。
VectorDB JSON 型 | Zilliz 固定フィールド型 | 備考 |
|---|---|---|
string | VARCHAR | 最大 65,535 バイトをサポート |
uint64 | INT32 | 型調整を伴う数値変換 |
double | DOUBLE | 直接的な型変換 |
array | ARRAY | 対応する要素型とともにサポート |
固定フィールドに変換された JSON フィールドについては、追加の属性を設定できます。
-
NULL許容: フィールドが null 値を受け入れるかどうかを決定します。この機能はデフォルトで有効になっています。詳細については、NULL許容属性を参照してください。
-
デフォルト値: データが欠落している場合のフォールバック値を設定します。詳細については、デフォルト値を参照してください。
-
パーティションキー: オプションで、INT64 または VARCHAR フィールドをパーティションキーとして指定できます。各コレクションは1つのパーティションキーのみをサポートし、選択したフィールドは NULL許容にできないことに注意してください。詳細については、パーティションキーの使用を参照してください。
Tencent Cloud VectorDB 固有の処理ルール
コレクションの命名規則
Tencent Cloud VectorDB のコレクション名は、以下の考慮事項に従って Zilliz Cloud に転送されます。
シナリオ | 影響 | ソリューション |
|---|---|---|
デフォルトの命名 | コレクション名はソースのコレクション名と完全に一致します | 名前は Tencent Cloud VectorDB からそのまま保持されます |
名前の競合 | データベースに同じ名前のコレクションが既に存在する場合、移行ジョブを送信できません | 既存のコレクションを削除する、別のターゲットデータベースを選択する、または移行設定時に名前を変更する |
特殊文字 | コレクション名は Qdrant からそのまま保持されます | コレクション名が Zilliz Cloud の命名規則に準拠していることを確認してください |