update_collection

Patch tunable collection-level configuration in place. Only the fields you set are sent to Qdrant — unset fields are left untouched.

Example

up:
  - op: update_collection
    collection: products
    hnsw_config:
      ef_construct: 256
    quantization_config:
      scalar:
        type: int8
        quantile: 0.99
        always_ram: true
    optimizers_config:
      indexing_threshold: 20000
    vectors:                       # patch existing named-vector params
      image:
        memory: cold               # move the vector storage (Qdrant 1.19+)
    payload:
      memory: cold                 # move the payload store (Qdrant 1.19+)
    id_tracker:
      memory: cold                 # move the point ID mapping (Qdrant 1.20+)

# update_collection is not auto-reversible (previous values aren't recorded).
# Spell out the inverse explicitly:
down:
  - op: update_collection
    collection: products
    quantization_config: disabled

Fields

FieldTypeRequiredDescription
collectionstringyesCollection to update.
hnsw_configHnswConfigSpecnoOverride collection-level HNSW params.
quantization_configQuantizationSpecnoSet or replace quantization (scalar / product / binary / turboquant / disabled).
optimizers_configOptimizersConfigSpecnoTune optimizer thresholds.
vectorsmap<name, VectorParamsDiff>noPatch params of existing named vectors (on_disk, memory, hnsw_config, quantization_config).
payloadPayloadStorageSpecnoMove the payload storage between memory tiers (Qdrant 1.19+).
id_trackerIdTrackerSpecnoMove the point ID mapping between memory tiers (Qdrant 1.20+).

At least one of those six fields must be set, otherwise revector refuses the op as a no-op.

Note. size and distance of a named vector are immutable. Per-vector hnsw_config / quantization_config / memory cannot be set at create_vector time either (Qdrant's add-vector API doesn't accept them); apply them with a follow-up update_collection step as shown above.

Reversibility

Not auto-reversible. The previous values aren't stored, so revector cannot synthesise an inverse. Provide an explicit down: block:

  • To restore prior numeric values, repeat update_collection with the original numbers.
  • To turn quantization back off, use quantization_config: disabled.