Offline Migration
Offline Migration transfers all existing data from a source Zilliz Cloud cluster to a target Zilliz Cloud cluster. This method supports migrations both within the same organization and across different organizations. It is ideal for scenarios where temporary write interruptions are acceptable, such as during planned maintenance or smaller-scale database transitions.
For migrations that require uninterrupted write operations, refer to Zero Downtime Migration.
Migration capabilities
Migration scope options
Migration Type | Description | Use Cases |
|---|---|---|
Within same project | Migrate between existing clusters in the same Zilliz Cloud project | Cluster upgrades, performance optimization, data consolidation |
Cross-project or organization | Migrate between existing clusters in different Zilliz Cloud projects or organizations | Company mergers, department transfers, multi-tenant scenarios |
Direct data transfer
Offline migration performs direct data replication between Zilliz Cloud clusters with the following characteristics:
-
Schema preservation: Source schema transferred unchanged to target cluster
-
No field modifications: Cannot rename fields, change data types, or modify field attributes during migration
-
Automatic indexing: AUTOINDEX automatically created for vector fields in target cluster
Prerequisites
Before starting your offline migration, ensure you meet these requirements:
General requirements
Requirement | Details |
|---|---|
User permissions | Organization Owner or Project Admin role |
Source cluster access | Source cluster must be accessible from the public internet |
Target cluster capacity | Sufficient CU size to accommodate source data (use the CU calculator) |
Cross-project or organization migration requirements
Requirement | Details |
|---|---|
Connection credentials | Public endpoint, API key, or cluster username and password for source cluster |
Network access | Ability to connect to source cluster from target organization |
Getting started
The following demo walks you through the complete offline migration process:
The migrated collections are not immediately available for search or query operations. You must manually load the collections in Zilliz Cloud to enable search and query functionalities. For details, refer to Load & Release.