From 0ead6b8f8b7e1188da00d7e23f67baf872684599 Mon Sep 17 00:00:00 2001 From: Dylan Couzon Date: Wed, 20 May 2026 11:35:38 -0400 Subject: [PATCH] Disambiguate document ids in with_lookup example Co-Authored-By: Claude Opus 4.7 (1M context) --- .../query-groups/with-lookup-ingest/csharp.cs | 8 ++++---- .../with-lookup-ingest/generated/csharp.md | 8 ++++---- .../with-lookup-ingest/generated/go.md | 8 ++++---- .../with-lookup-ingest/generated/java.md | 8 ++++---- .../with-lookup-ingest/generated/python.md | 8 ++++---- .../with-lookup-ingest/generated/rust.md | 8 ++++---- .../with-lookup-ingest/generated/typescript.md | 8 ++++---- .../query-groups/with-lookup-ingest/go.go | 8 ++++---- .../query-groups/with-lookup-ingest/http.md | 8 ++++---- .../query-groups/with-lookup-ingest/java.java | 8 ++++---- .../query-groups/with-lookup-ingest/python.py | 8 ++++---- .../query-groups/with-lookup-ingest/rust.rs | 8 ++++---- .../query-groups/with-lookup-ingest/typescript.ts | 8 ++++---- .../content/documentation/search/search.md | 15 ++++++++------- 14 files changed, 60 insertions(+), 59 deletions(-) diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/csharp.cs b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/csharp.cs index 09fa0f7f3..d809f1263 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/csharp.cs +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/csharp.cs @@ -13,7 +13,7 @@ public class Snippet { new() { - Id = 1, + Id = 200, Vectors = new Dictionary(), Payload = { @@ -23,7 +23,7 @@ public class Snippet }, new() { - Id = 2, + Id = 201, Vectors = new Dictionary(), Payload = { @@ -42,13 +42,13 @@ public class Snippet { Id = 0, Vectors = new float[] { 0.1f, 0.2f, 0.3f, 0.4f }, - Payload = { ["document_id"] = 1 }, + Payload = { ["document_id"] = 200 }, }, new() { Id = 1, Vectors = new float[] { 0.5f, 0.6f, 0.7f, 0.8f }, - Payload = { ["document_id"] = 2 }, + Payload = { ["document_id"] = 201 }, }, } ); diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/csharp.md b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/csharp.md index fc64b6633..910472b83 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/csharp.md +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/csharp.md @@ -10,7 +10,7 @@ await client.UpsertAsync( { new() { - Id = 1, + Id = 200, Vectors = new Dictionary(), Payload = { @@ -20,7 +20,7 @@ await client.UpsertAsync( }, new() { - Id = 2, + Id = 201, Vectors = new Dictionary(), Payload = { @@ -39,13 +39,13 @@ await client.UpsertAsync( { Id = 0, Vectors = new float[] { 0.1f, 0.2f, 0.3f, 0.4f }, - Payload = { ["document_id"] = 1 }, + Payload = { ["document_id"] = 200 }, }, new() { Id = 1, Vectors = new float[] { 0.5f, 0.6f, 0.7f, 0.8f }, - Payload = { ["document_id"] = 2 }, + Payload = { ["document_id"] = 201 }, }, } ); diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/go.md b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/go.md index c1f3c0acc..2c93a219f 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/go.md +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/go.md @@ -14,7 +14,7 @@ client.Upsert(context.Background(), &qdrant.UpsertPoints{ CollectionName: "documents", Points: []*qdrant.PointStruct{ { - Id: qdrant.NewIDNum(1), + Id: qdrant.NewIDNum(200), Vectors: qdrant.NewVectorsMap(map[string]*qdrant.Vector{}), Payload: qdrant.NewValueMap(map[string]any{ "title": "Document A", @@ -22,7 +22,7 @@ client.Upsert(context.Background(), &qdrant.UpsertPoints{ }), }, { - Id: qdrant.NewIDNum(2), + Id: qdrant.NewIDNum(201), Vectors: qdrant.NewVectorsMap(map[string]*qdrant.Vector{}), Payload: qdrant.NewValueMap(map[string]any{ "title": "Document B", @@ -38,12 +38,12 @@ client.Upsert(context.Background(), &qdrant.UpsertPoints{ { Id: qdrant.NewIDNum(0), Vectors: qdrant.NewVectors(0.1, 0.2, 0.3, 0.4), - Payload: qdrant.NewValueMap(map[string]any{"document_id": 1}), + Payload: qdrant.NewValueMap(map[string]any{"document_id": 200}), }, { Id: qdrant.NewIDNum(1), Vectors: qdrant.NewVectors(0.5, 0.6, 0.7, 0.8), - Payload: qdrant.NewValueMap(map[string]any{"document_id": 2}), + Payload: qdrant.NewValueMap(map[string]any{"document_id": 201}), }, }, }) diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/java.md b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/java.md index a150b8480..1de745150 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/java.md +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/java.md @@ -17,14 +17,14 @@ client.upsertAsync( "documents", List.of( PointStruct.newBuilder() - .setId(id(1)) + .setId(id(200)) .setVectors(namedVectors(Map.of())) .putAllPayload(Map.of( "title", value("Document A"), "text", value("This is document A"))) .build(), PointStruct.newBuilder() - .setId(id(2)) + .setId(id(201)) .setVectors(namedVectors(Map.of())) .putAllPayload(Map.of( "title", value("Document B"), @@ -37,11 +37,11 @@ client.upsertAsync( PointStruct.newBuilder() .setId(id(0)) .setVectors(vectors(0.1f, 0.2f, 0.3f, 0.4f)) - .putAllPayload(Map.of("document_id", value(1))) + .putAllPayload(Map.of("document_id", value(200))) .build(), PointStruct.newBuilder() .setId(id(1)) .setVectors(vectors(0.5f, 0.6f, 0.7f, 0.8f)) - .putAllPayload(Map.of("document_id", value(2))) + .putAllPayload(Map.of("document_id", value(201))) .build())).get(); ``` diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/python.md b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/python.md index aa162cba5..9873cdf67 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/python.md +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/python.md @@ -3,12 +3,12 @@ client.upsert( collection_name="documents", points=[ models.PointStruct( - id=1, + id=200, vector={}, payload={"title": "Document A", "text": "This is document A"}, ), models.PointStruct( - id=2, + id=201, vector={}, payload={"title": "Document B", "text": "This is document B"}, ), @@ -21,12 +21,12 @@ client.upsert( models.PointStruct( id=0, vector=[0.1, 0.2, 0.3, 0.4], - payload={"document_id": 1}, + payload={"document_id": 200}, ), models.PointStruct( id=1, vector=[0.5, 0.6, 0.7, 0.8], - payload={"document_id": 2}, + payload={"document_id": 201}, ), ], ) diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/rust.md b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/rust.md index cb92f5f7f..9b31189eb 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/rust.md +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/rust.md @@ -9,7 +9,7 @@ client "documents", vec![ PointStruct::new( - 1, + 200, HashMap::::new(), [ ("title", "Document A".into()), @@ -17,7 +17,7 @@ client ], ), PointStruct::new( - 2, + 201, HashMap::::new(), [ ("title", "Document B".into()), @@ -32,8 +32,8 @@ client .upsert_points(UpsertPointsBuilder::new( "chunks", vec![ - PointStruct::new(0, vec![0.1, 0.2, 0.3, 0.4], [("document_id", 1.into())]), - PointStruct::new(1, vec![0.5, 0.6, 0.7, 0.8], [("document_id", 2.into())]), + PointStruct::new(0, vec![0.1, 0.2, 0.3, 0.4], [("document_id", 200.into())]), + PointStruct::new(1, vec![0.5, 0.6, 0.7, 0.8], [("document_id", 201.into())]), ], )) .await?; diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/typescript.md b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/typescript.md index 1c773dc07..fc802f45e 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/typescript.md +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/generated/typescript.md @@ -2,12 +2,12 @@ await client.upsert("documents", { points: [ { - id: 1, + id: 200, vector: {}, payload: { title: "Document A", text: "This is document A" }, }, { - id: 2, + id: 201, vector: {}, payload: { title: "Document B", text: "This is document B" }, }, @@ -19,12 +19,12 @@ await client.upsert("chunks", { { id: 0, vector: [0.1, 0.2, 0.3, 0.4], - payload: { document_id: 1 }, + payload: { document_id: 200 }, }, { id: 1, vector: [0.5, 0.6, 0.7, 0.8], - payload: { document_id: 2 }, + payload: { document_id: 201 }, }, ], }); diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/go.go b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/go.go index d37b1b2a0..bdccd317e 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/go.go +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/go.go @@ -18,7 +18,7 @@ func Main() { CollectionName: "documents", Points: []*qdrant.PointStruct{ { - Id: qdrant.NewIDNum(1), + Id: qdrant.NewIDNum(200), Vectors: qdrant.NewVectorsMap(map[string]*qdrant.Vector{}), Payload: qdrant.NewValueMap(map[string]any{ "title": "Document A", @@ -26,7 +26,7 @@ func Main() { }), }, { - Id: qdrant.NewIDNum(2), + Id: qdrant.NewIDNum(201), Vectors: qdrant.NewVectorsMap(map[string]*qdrant.Vector{}), Payload: qdrant.NewValueMap(map[string]any{ "title": "Document B", @@ -42,12 +42,12 @@ func Main() { { Id: qdrant.NewIDNum(0), Vectors: qdrant.NewVectors(0.1, 0.2, 0.3, 0.4), - Payload: qdrant.NewValueMap(map[string]any{"document_id": 1}), + Payload: qdrant.NewValueMap(map[string]any{"document_id": 200}), }, { Id: qdrant.NewIDNum(1), Vectors: qdrant.NewVectors(0.5, 0.6, 0.7, 0.8), - Payload: qdrant.NewValueMap(map[string]any{"document_id": 2}), + Payload: qdrant.NewValueMap(map[string]any{"document_id": 201}), }, }, }) diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/http.md b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/http.md index e4cdbdd34..7d3c04215 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/http.md +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/http.md @@ -3,12 +3,12 @@ PUT /collections/documents/points { "points": [ { - "id": 1, + "id": 200, "vector": {}, "payload": {"title": "Document A", "text": "This is document A"} }, { - "id": 2, + "id": 201, "vector": {}, "payload": {"title": "Document B", "text": "This is document B"} } @@ -21,12 +21,12 @@ PUT /collections/chunks/points { "id": 0, "vector": [0.1, 0.2, 0.3, 0.4], - "payload": {"document_id": 1} + "payload": {"document_id": 200} }, { "id": 1, "vector": [0.5, 0.6, 0.7, 0.8], - "payload": {"document_id": 2} + "payload": {"document_id": 201} } ] } diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/java.java b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/java.java index 63681b7a7..758a52675 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/java.java +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/java.java @@ -20,14 +20,14 @@ public class Snippet { "documents", List.of( PointStruct.newBuilder() - .setId(id(1)) + .setId(id(200)) .setVectors(namedVectors(Map.of())) .putAllPayload(Map.of( "title", value("Document A"), "text", value("This is document A"))) .build(), PointStruct.newBuilder() - .setId(id(2)) + .setId(id(201)) .setVectors(namedVectors(Map.of())) .putAllPayload(Map.of( "title", value("Document B"), @@ -40,12 +40,12 @@ public class Snippet { PointStruct.newBuilder() .setId(id(0)) .setVectors(vectors(0.1f, 0.2f, 0.3f, 0.4f)) - .putAllPayload(Map.of("document_id", value(1))) + .putAllPayload(Map.of("document_id", value(200))) .build(), PointStruct.newBuilder() .setId(id(1)) .setVectors(vectors(0.5f, 0.6f, 0.7f, 0.8f)) - .putAllPayload(Map.of("document_id", value(2))) + .putAllPayload(Map.of("document_id", value(201))) .build())).get(); } } diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/python.py b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/python.py index c3d32c597..1719e34db 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/python.py +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/python.py @@ -6,12 +6,12 @@ client.upsert( collection_name="documents", points=[ models.PointStruct( - id=1, + id=200, vector={}, payload={"title": "Document A", "text": "This is document A"}, ), models.PointStruct( - id=2, + id=201, vector={}, payload={"title": "Document B", "text": "This is document B"}, ), @@ -24,12 +24,12 @@ client.upsert( models.PointStruct( id=0, vector=[0.1, 0.2, 0.3, 0.4], - payload={"document_id": 1}, + payload={"document_id": 200}, ), models.PointStruct( id=1, vector=[0.5, 0.6, 0.7, 0.8], - payload={"document_id": 2}, + payload={"document_id": 201}, ), ], ) diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/rust.rs b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/rust.rs index e987bee2b..7eb3a68d0 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/rust.rs +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/rust.rs @@ -11,7 +11,7 @@ pub async fn main() -> anyhow::Result<()> { "documents", vec![ PointStruct::new( - 1, + 200, HashMap::::new(), [ ("title", "Document A".into()), @@ -19,7 +19,7 @@ pub async fn main() -> anyhow::Result<()> { ], ), PointStruct::new( - 2, + 201, HashMap::::new(), [ ("title", "Document B".into()), @@ -34,8 +34,8 @@ pub async fn main() -> anyhow::Result<()> { .upsert_points(UpsertPointsBuilder::new( "chunks", vec![ - PointStruct::new(0, vec![0.1, 0.2, 0.3, 0.4], [("document_id", 1.into())]), - PointStruct::new(1, vec![0.5, 0.6, 0.7, 0.8], [("document_id", 2.into())]), + PointStruct::new(0, vec![0.1, 0.2, 0.3, 0.4], [("document_id", 200.into())]), + PointStruct::new(1, vec![0.5, 0.6, 0.7, 0.8], [("document_id", 201.into())]), ], )) .await?; diff --git a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/typescript.ts b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/typescript.ts index d458c2e5f..ad8aa578b 100644 --- a/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/typescript.ts +++ b/qdrant-landing/content/documentation/headless/snippets/query-groups/with-lookup-ingest/typescript.ts @@ -5,12 +5,12 @@ const client = new QdrantClient({ host: "localhost", port: 6333 }); // @hide await client.upsert("documents", { points: [ { - id: 1, + id: 200, vector: {}, payload: { title: "Document A", text: "This is document A" }, }, { - id: 2, + id: 201, vector: {}, payload: { title: "Document B", text: "This is document B" }, }, @@ -22,12 +22,12 @@ await client.upsert("chunks", { { id: 0, vector: [0.1, 0.2, 0.3, 0.4], - payload: { document_id: 1 }, + payload: { document_id: 200 }, }, { id: 1, vector: [0.5, 0.6, 0.7, 0.8], - payload: { document_id: 2 }, + payload: { document_id: 201 }, }, ], }); diff --git a/qdrant-landing/content/documentation/search/search.md b/qdrant-landing/content/documentation/search/search.md index 043df68ae..5f0e86257 100644 --- a/qdrant-landing/content/documentation/search/search.md +++ b/qdrant-landing/content/documentation/search/search.md @@ -428,19 +428,20 @@ Query the `chunks` collection with `group_by="document_id"` and `with_lookup` po You can also pass `with_lookup="documents"` as a shorthand. It uses the server defaults (`with_payload=True`, `with_vectors=False`), so the documents' vectors are not returned. Use the explicit `WithLookup(...)` form when you need those vectors back. -The looked-up result appears under `lookup` in each group. +The looked-up result appears under `lookup` in each group. Below, chunk id 1 shows up in both groups because its `document_id` payload is an array (`[200, 201]`), placing the chunk into every matching group. ```json { "result": { "groups": [ { - "id": 1, + "id": 200, "hits": [ - { "id": 0, "score": 0.93 } + { "id": 0, "score": 0.91 }, + { "id": 1, "score": 0.85 } ], "lookup": { - "id": 1, + "id": 200, "payload": { "title": "Document A", "text": "This is document A" @@ -448,12 +449,12 @@ The looked-up result appears under `lookup` in each group. } }, { - "id": 2, + "id": 201, "hits": [ - { "id": 1, "score": 0.88 } + { "id": 1, "score": 0.85 } ], "lookup": { - "id": 2, + "id": 201, "payload": { "title": "Document B", "text": "This is document B"