PostgreSQL から Zilliz Cloud への移行

このトピックでは、PostgreSQL から移行する際のデータ型マッピング、コレクション命名規則、および考慮事項について Zilliz Cloud がどのように処理するかを説明します。

前提条件

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

Requirement	Details
ネットワーク access	Source PostgreSQL database must be accessible from the public internet
データベース access	Valid database endpoint, username, and password with necessary permissions
pgvector extension	Tables must use pgvector extension for vector data storage
Vector field requirement	Each source table must contain at least one vector field, and ベクトルフィールド cannot contain null values.
データ availability	Source tables must contain data. Empty tables cannot be migrated.

Requirement	Details
User role	組織オーナー or プロジェクト管理者
Cluster capacity	Sufficient storage and compute resources (use the CU calculator to estimate CU size)
ネットワーク access	Add Zilliz Cloud IPs to allowlists if using network restrictions

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

PostgreSQL Field Type	Zilliz Cloud Field Type	Description
Primary key	Primary key / 自動ID	Single-field primary key: Mapped directly as the target collection's primary key. Absence of primary key: 自動ID is enabled for the target collection to support tables without a primary key. Composite primary key: 自動ID is enabled; composite keys are treated as regular スカラーフィールド. When migrating data, you can enable 自動ID. However, if you do so, the original primary key values from your source collection will be discarded.
vector	FLOAT_VECTOR	Vector dimensions remain unchanged.
text/varchar/date/time	VARCHAR	Stored as a string.
bigint	INT64	-
integer	INT32	-
smallint	INT16	-
double precision	DOUBLE	-
real	FLOAT	-
boolean	BOOL	-
array	ARRAY	-
json	JSON	-

PostgreSQL のテーブル名は、以下の考慮事項を踏まえて Zilliz Cloud に転送されます。

Scenario	Impact	ソリューション
Default naming	Collection names match source table names exactly	Names are preserved as-is from PostgreSQL
名前の競合	Cannot submit job if a collection with the same name already exists	Delete existing collection, choose a different database, or rename during migration configuration
Collection name modification	Supported during migration	You can rename collections during the migration configuration process

以下の機能は、PostgreSQL からの移行においてサポートされていません。

制限ation	Impact	Alternative
Dynamic to fixed field conversion	Cannot convert existing dynamic fields to fixed types	Fields maintain their original dynamic nature
Add more fields	Cannot add new fields during migration	Only existing Elasticsearch fields are migrated