Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

QdrantMigration

qdrantmigrations.qdrant.io, short name qmig, namespaced. A point-by-point copy of collections from any Qdrant into a managed cluster. The spec is immutable.

Spec

FieldDefaultDescription
source.clusterRef.nameA QdrantCluster. Exclusive with endpoint
source.clusterRef.namespaceown namespace
source.endpoint.urlhttp:// or https:// URL of any Qdrant. Exclusive with clusterRef
source.endpoint.apiKeySecretRef.name, .keynoneAPI key for the source, Secret in the migration's namespace
source.endpoint.caSecretRef.name, .keysystem trustPEM bundle for a private CA
targetClusterRef.namerequiredThe managed cluster to copy into
targetClusterRef.namespaceown namespace
collections[]all on the sourceCollections to copy
collectionMapping{}Source name to target name
batchSize256Points per scroll and upsert, 1 to 10000
createMissingtrueCreate absent target collections from the source configuration
target.shardNumber, replicationFactor, writeConsistencyFactortarget defaultsApplied to collections the migration creates

Admission rules: exactly one of source.clusterRef and source.endpoint; the spec cannot change.

Status

FieldMeaning
phasePending, Running, Completed or Failed
startTime, completionTime
source<namespace>/<name> or the endpoint URL
collections[]name, targetName, status, pointsTotal, pointsCopied, error
progresscollectionsTotal, collectionsCompleted, pointsTotal, pointsCopied, percentage
errorThe first failed collection's error
conditions[Complete]MigrationCompleted or MigrationFailed

Behavior

On create only. Resolves both sides, retrying every thirty seconds while the target cluster is missing or not ready or a Secret is absent, counts the points of each selected collection, then per collection creates the target collection and its payload indexes when missing and allowed, scrolls pages with payload and vectors, and upserts them grouped by shard key with wait=true. Progress is patched every twenty batches. Completed, or Failed when any collection failed.

Print columns: SOURCE, TARGET, PHASE, PROGRESS, AGE.