Files
qdrant/lib/edge/python/examples/demo.py
qdrant-cloud-bot 09b3ff00cb refactor(edge): split EdgeShard load into new() and load() (#8326)
* refactor(edge): split EdgeShard load into new() and load()

- new(path, config): create edge shard only when path has no existing segments
- load(path, config?): load from existing files; config optional (load from
  edge_config.json or infer from segments)
- Helpers: has_existing_segments, ensure_dirs_and_open_wal, resolve_initial_config,
  load_segments, ensure_appendable_segment
- Python: EdgeShard.create_new(path, config); __init__ still calls load()
- Examples use new() for creation and load(path, None) for reopen
- Error instead of panic on config mismatch; explicit load/create in Python
- fix: use OptimizerThresholds.deferred_internal_id for dev compatibility

Made-with: Cursor

* rollback threshold changes

* fix(edge): address dancixx review comments

- Persist inferred config in load() when edge_config.json does not exist
  (SaveOnDisk::new only saves when file exists)
- Python: add #[new] delegating to load() for backward compatibility
- qdrant_edge.pyi: Optional return types for deleted_threshold,
  vacuum_min_vector_number, default_segment_number; add __init__ doc

Made-with: Cursor

* Revert "fix(edge): address dancixx review comments"

This reverts commit 370e21a6c74c41210e1658f89814395cb86ed81c.

* fix: optional returns

* fix: save config it is not exist

* fix: save data on disk always

* fix: python examples

* chore: remove edge.close()

* fix: wal lock

* fix: rename of EdgeShardConfig -> EdgeConfig

---------

Co-authored-by: Cursor Agent <agent@cursor.com>
Co-authored-by: Andrey Vasnetsov <andrey@vasnetsov.com>
Co-authored-by: Daniel Boros <dancixx@gmail.com>
2026-03-18 15:25:01 +01:00

192 lines
3.9 KiB
Python
Executable File

#!/usr/bin/env python3
# See lib/edge/publish/examples/src/bin/demo.rs for the equivalent Rust example.
from common import *
from qdrant_edge import *
print("---- Point conversions ----")
points = [
Point(10, [[1, 2, 3], [3, 4, 5]], {}),
Point(11, {"sparse": SparseVector(indices=[0, 2], values=[1.0, 3.0])}, {}),
]
# Test points conversion into internal representation and back
for point in points:
print(point)
print("---- Load shard ----")
shard = load_new_shard()
print("---- Upsert ----")
shard.update(
UpdateOperation.upsert_points(
[
Point(
1,
[6.0, 9.0, 4.0, 2.0],
{
"null": None,
"str": "string",
"uint": 42,
"int": -69,
"float": 4.20,
"bool": True,
"obj": {
"null": None,
"str": "string",
"uint": 42,
"int": -69,
"float": 4.20,
"bool": True,
"obj": {},
"arr": [],
},
"arr": [None, "string", 42, -69, 4.20, True, {}, []],
},
),
Point(
"e9408f2b-b917-4af1-ab75-d97ac6b2c047",
[6.0, 9.0, 3.0, -2.0],
{
"hello": "world",
"price": 199.99,
},
),
Point(
uuid.uuid4(),
[1.0, 6.0, 4.0, 2.0],
{
"hello": "world",
"price": 999.99,
},
),
]
)
)
print("---- Query ----")
result = shard.query(
QueryRequest(
query=Query.Nearest([6.0, 9.0, 4.0, 2.0]),
limit=10,
with_vector=True,
with_payload=True,
)
)
for point in result:
print(point)
print("---- Search ----")
points = shard.search(
SearchRequest(
query=Query.Nearest([1.0, 1.0, 1.0, 1.0]),
limit=10,
with_vector=True,
with_payload=True,
)
)
for point in points:
print(point)
print("---- Search + Filter ----")
search_filter = Filter(
must=[
FieldCondition(
key="hello",
match=MatchTextAny(text_any="world"),
),
FieldCondition(
key="price",
range=RangeFloat(gte=500.0),
),
]
)
points = shard.search(
SearchRequest(
query=Query.Nearest([1.0, 1.0, 1.0, 1.0]),
filter=search_filter,
limit=10,
with_vector=True,
with_payload=True,
)
)
for point in points:
print(point)
print("---- Retrieve ----")
points = shard.retrieve(point_ids=[1], with_vector=True, with_payload=True)
for point in points:
print(point)
print("---- Scroll ----")
scroll_result, next_offset = shard.scroll(ScrollRequest(limit=2))
for point in scroll_result:
print(point)
while next_offset is not None:
print(f"--- Next scroll (offset = {next_offset})---")
scroll_result, next_offset = shard.scroll(
ScrollRequest(limit=2, offset=next_offset)
)
for point in scroll_result:
print(point)
print("---- Count ----")
count = shard.count(CountRequest(exact=True))
print(f"Total points count: {count}")
print("---- Facet ----")
shard.update(UpdateOperation.create_field_index("hello", PayloadSchemaType.Keyword))
response = shard.facet(
FacetRequest(
key="hello",
limit=10,
exact=False,
)
)
print(f"Facet results ({len(response)} hits):")
for hit in response:
print(f" {hit.value}: {hit.count}")
print("---- Info ----")
info = shard.info()
print(info)
print("---- Close and reopen shard ----")
shard.close()
reopened_shard = EdgeShard.load(TMP_DIR)
print(f"Edge shard reopened. Approx Points: {reopened_shard.info().points_count}")