Tencent Cloud から Zilliz Cloud への移行
このトピックでは、Tencent Cloud VectorDB から移行する際に、Zilliz Cloud がデータ型マッピング、JSON フィールド変換、コレクションの命名規則をどのように処理するかについて説明します。
事前準備
Tencent Cloud VectorDB から Zilliz Cloud への移行を開始する前に、以下の要件を満たしていることを確認してください。
Tencent Cloud VectorDB の要件
| 要件 | 詳細 |
|---|---|
| ネットワークアクセス | ソースの VectorDB インスタンスはパブリックインターネットからアクセス可能である必要があります |
| API アクセス | 必要な権限を持つ有効なインスタンス URL と API key |
| データの可用性 | ソースのコレクションにはデータが含まれている必要があります。空のコレクションは移行できません。 |
Zilliz Cloud の要件
| 要件 | 詳細 |
|---|---|
| ユーザーロール | Organization Owner または Project Admin |
| クラスター容量 | 十分なストレージとコンピュートリソース(CU サイズの見積もりには CU calculator を使用) |
| ネットワークアクセス | ネットワーク制限を使用している場合は、許可リストに Zilliz Cloud IPs を追加してください |
データ型マッピング
Tencent Cloud VectorDB のデータ型が Zilliz Cloud にどのようにマッピングされるかを理解することは、移行を計画するうえで重要です。
| VectorDB フィールドタイプ | Zilliz Cloud フィールドタイプ | 説明 |
|---|---|---|
| 主キー | VARCHAR (Primary key) | Tencent Cloud VectorDB の主キーは、Zilliz Cloud の主キーとして自動的にマッピングされます。 データを移行する際には Auto ID を有効にできます。ただし、有効にするとソースコレクションの元の主キー値は破棄されます。 |
| Dense ベクトル | FLOAT_VECTOR | Dense ベクトルフィールドは、変更を加えることなく FLOAT_VECTOR として転送されます。 |
| JSON | JSON (dynamic fields) | デフォルトでは動的スキーマとしてマッピングされ、固定フィールドに変換できます。 詳細については Dynamic Field を参照してください。 |
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 フィールドについては、追加の属性を設定できます。
-
Nullable: フィールドが null 値を受け入れられるかどうかを決定します。この機能はデフォルトで有効です。詳細については、Nullable attribute を参照してください。
-
Default Value: データが欠落している場合のフォールバック値を設定します。詳細については、Default values を参照してください。
-
Partition Key: 必要に応じて INT64 または VARCHAR フィールドをパーティションキーとして指定できます。各コレクションがサポートするパーティションキーは 1 つだけであり、選択したフィールドは nullable にできない点に注意してください。詳細については、Use Partition Key を参照してください。
Tencent Cloud VectorDB 固有の処理ルール
コレクションの命名規則
Tencent Cloud VectorDB のコレクション名は、以下の点を考慮して Zilliz Cloud に転送されます。
| シナリオ | 影響 | 解決策 |
|---|---|---|
| デフォルト命名 | コレクション名はソースのコレクション名と完全に一致します | 名前は Tencent Cloud VectorDB からそのまま保持されます |
| 命名の競合 | 同じ名前のコレクションがデータベースにすでに存在する場合、移行ジョブを送信できません | 既存のコレクションを削除するか、別のターゲットデータベースを選択するか、移行設定時に名前を変更してください |
| 特殊文字 | コレクション名は Qdrant からそのまま保持されます | コレクション名が Zilliz Cloud の命名規則に準拠していることを確認してください |