Files
qdrant/tests/consensus_tests/test_collection_shard_update.py
qdrant-cloud-bot ee2107c2db fix: validate vector dimensions before WAL write for async upserts (#9058)
* fix: validate vector dimensions before WAL write for async upserts

When upserting points with wait=false (the default), dimension
mismatches were silently discarded during background processing.
The API returned 200 "acknowledged" but the points were never stored,
causing silent data loss with no error feedback to the user.

This adds an early dimension validation check in do_upsert_points()
that runs before the operation is written to WAL. This ensures that
dimension errors are returned to the client regardless of the wait
parameter, matching the behavior of wait=true.

The validation handles all vector types:
- Dense single vectors
- Multi-dense vectors
- Named vectors (dense, multi-dense, sparse)
- Sparse vectors are skipped (no fixed dimension)

Closes #9039

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor: move vector dimension validation into dedicated module

Extract validate_vector_dimensions and helper functions from update.rs
into src/common/validate_vectors.rs for better code organization.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: update shard update test for early dimension validation

The test expected a shard-level error message, but now dimension
mismatches are caught before reaching the shards. Update the assertion
to accept either the early validation error or the shard-level error.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: assert actual dimension error message in shard update test

Check for the descriptive error ("Vector dimension error: expected dim: 4, got 3")
rather than the generic shard failure wrapper.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor Agent <agent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-22 10:43:19 +02:00

138 lines
4.1 KiB
Python

import pathlib
from .utils import *
from .assertions import assert_http_ok
N_PEERS = 3
N_SHARDS = 4
N_REPLICA = 2
def test_collection_shard_update(tmp_path: pathlib.Path):
assert_project_root()
peer_dirs = make_peer_folders(tmp_path, N_PEERS)
# Gathers REST API uris
peer_api_uris = []
# Start bootstrap
(bootstrap_api_uri, bootstrap_uri) = start_first_peer(
peer_dirs[0], "peer_0_0.log")
peer_api_uris.append(bootstrap_api_uri)
# Wait for leader
leader = wait_peer_added(bootstrap_api_uri)
# Start other peers
for i in range(1, len(peer_dirs)):
peer_api_uris.append(start_peer(
peer_dirs[i], f"peer_0_{i}.log", bootstrap_uri))
# Wait for cluster
wait_for_uniform_cluster_status(peer_api_uris, leader)
# Check that there are no collections on all peers
for uri in peer_api_uris:
r = requests.get(f"{uri}/collections")
assert_http_ok(r)
assert len(r.json()["result"]["collections"]) == 0
# Create collection in first peer
r = requests.put(
f"{peer_api_uris[0]}/collections/test_collection", json={
"vectors": {
"image": {
"size": 4,
"distance": "Dot"
},
"text": {
"size": 4,
"distance": "Cosine"
}
},
"shard_number": N_SHARDS,
"replication_factor": N_REPLICA,
})
assert_http_ok(r)
# Check that it exists on all peers
wait_collection_exists_and_active_on_all_peers(collection_name="test_collection", peer_api_uris=peer_api_uris)
# Check collection's cluster info
collection_cluster_info = get_collection_cluster_info(peer_api_uris[0], "test_collection")
assert collection_cluster_info["shard_count"] == N_SHARDS
# Create request with missing named vectors in first peer's collection
r = requests.put(
f"{peer_api_uris[0]}/collections/test_collection/points?wait=true", json={
"points": [
{
"id": 1,
"vector": {
"image": [0.05, 0.61, 0.76, 0.74],
"text": [0.05, 0.61, 0.76, 0.74]
}
},
{
"id": 2,
"vector": {
"image": [0.05, 0.61, 0.76, 0.74]
}
},
{
"id": 3,
"vector": {
"image": [0.05, 0.61, 0.76, 0.74],
"text": [0.05, 0.61, 0.76, 0.74]
}
},
{
"id": 4,
"vector": {
"image": [0.05, 0.61, 0.76, 0.74],
"text": [0.05, 0.61, 0.76, 0.74]
}
}
]
})
assert_http_ok(r)
# Create malformed points in first peer's collection
r = requests.put(
f"{peer_api_uris[0]}/collections/test_collection/points?wait=true", json={
"points": [
{
"id": 1,
"vector": {
"image": [0.05, 0.61, 0.76, 0.74],
"text": [0.05, 0.61, 0.76, 0.74]
}
},
{
"id": 2,
"vector": {
"image": [0.05, 0.61, 0.76]
}
},
{
"id": 3,
"vector": {
"image": [0.05, 0.61, 0.76, 0.74],
"text": [0.05, 0.61, 0.76, 0.74]
}
},
{
"id": 4,
"vector": {
"image": [0.05, 0.61, 0.76, 0.74],
"text": [0.05, 0.61, 0.76, 0.74]
}
}
]
})
assert r.status_code == 400
error = r.json()["status"]["error"]
assert "Vector dimension error: expected dim: 4, got 3" in error