[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-qdrant-edge-shard-query":3,"mdc-fo2dlt-key":53,"related-org-qdrant-edge-shard-query":2495,"related-repo-qdrant-edge-shard-query":2648},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":48,"sourceUrl":51,"mdContent":52},"edge-shard-query","run queries against Qdrant edge shards","Use the `edge-shard-query` CLI to run scroll \u002F dense search \u002F sparse search against a read-only Qdrant edge shard, reading segments directly from S3, GCS, or a live Qdrant peer over gRPC — no Qdrant server required. Also covers the live-reload mode for watching a leader's writes propagate. Use when asked to query, inspect, debug, or live-watch an edge shard on object storage.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"qdrant","Qdrant","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fqdrant.png",[12,14,17,20],{"name":9,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"CLI","cli",{"name":18,"slug":19,"type":13},"Database","database",{"name":21,"slug":22,"type":13},"Search","search",33836,"https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fqdrant","2026-08-08T04:19:05.59593",null,2562,[29,30,31,32,33,34,35,36,37,38,39,40,41,22,42,43,44,45,46,47],"ai-search","ai-search-engine","embeddings-similarity","hnsw","hybrid-search","image-search","knn-algorithm","machine-learning","mlops","nearest-neighbor-search","neural-network","neural-search","recommender-system","search-engine","search-engines","similarity-search","vector-database","vector-search","vector-search-engine",{"repoUrl":24,"stars":23,"forks":27,"topics":49,"description":50},[29,30,31,32,33,34,35,36,37,38,39,40,41,22,42,43,44,45,46,47],"Qdrant - High-performance, massive-scale Vector Database and Vector Search Engine for the next generation of AI. Also available in the cloud https:\u002F\u002Fcloud.qdrant.io\u002F","https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fqdrant\u002Ftree\u002FHEAD\u002Flib\u002Fedge\u002Ftools\u002Fshard_query","---\nname: edge-shard-query\ndescription: Use the `edge-shard-query` CLI to run scroll \u002F dense search \u002F sparse search against a read-only Qdrant edge shard, reading segments directly from S3, GCS, or a live Qdrant peer over gRPC — no Qdrant server required. Also covers the live-reload mode for watching a leader's writes propagate. Use when asked to query, inspect, debug, or live-watch an edge shard on object storage.\n---\n\n# edge-shard-query\n\nAn experimental binary that opens a `ReadOnlyEdgeShard` **directly over object storage** (S3\u002FS3-compatible or GCS) — or over a running Qdrant peer's `StorageRead` gRPC service — and runs a single read request against it.\n\nThere is no Qdrant server in the loop for the object-storage backends. The tool reads segment files itself, through a local disk cache, so it is the fastest way to answer \"what does the data in this bucket actually contain?\" and to watch a leader's writes land.\n\n## Running it\n\n```sh\ncargo run -p edge-shard-query -- \u003CCONNECTION FLAGS> \u003CSUBCOMMAND> \u003CSUBCOMMAND FLAGS>\n```\n\nConnection flags must come **before** the subcommand; request flags come after it. For repeated use, build once (`cargo build -p edge-shard-query --release`) and call `target\u002Frelease\u002Fedge-shard-query` directly.\n\nLogging is on at `info` by default; raise it with `RUST_LOG=debug`.\n\n## Choosing a backend\n\n`--backend` selects where segments are read from. It defaults to `aws`.\n\n| Backend | What it reads | Shard addressed by |\n| --- | --- | --- |\n| `aws` | AWS S3 or any S3-compatible store (MinIO, RustFS, LocalStack) | `--bucket` + `--prefix` |\n| `gcs` | Google Cloud Storage | `--bucket` + `--prefix` |\n| `uio-grpc` | A running Qdrant peer's `StorageRead` gRPC service | `--collection` + `--shard-id` |\n\n### `--prefix` (object storage only)\n\nThe key prefix inside the bucket that points at the **edge-shard root** — the directory containing `edge_config.json` and `segments\u002F`. Empty means the bucket root. A shard for collection `foo`, shard `0` typically lives at `foo\u002F0`.\n\nAn `edge_config.json` is *not* required: segments are discovered from the leader's segment manifest, and the shard config is derived from the segments themselves. Leave `--prefix` empty for `uio-grpc`, which addresses the shard by collection and shard id instead.\n\n### Connection flags\n\nAll of these accept an environment variable as a fallback, shown in brackets.\n\n**AWS \u002F S3-compatible**\n- `--bucket` [`BLOB_BUCKET`] — bucket name, no scheme prefix. Required.\n- `--endpoint` [`S3_ENDPOINT`] — custom S3 endpoint. Set for MinIO\u002FRustFS\u002FLocalStack; **omit for real AWS**.\n- `--region` [`S3_REGION`] — e.g. `us-east-1`. Required for real AWS, optional for S3-compatible endpoints.\n- `--access-key` [`S3_ACCESS_KEY`] \u002F `--secret-key` [`S3_SECRET_KEY`] — must be given **together**. If both are omitted, the AWS default credential chain is used.\n- `--session-token` [`S3_SESSION_TOKEN`] — for short-lived credentials.\n- `--s3-express` [`S3_EXPRESS`] — for S3 Express One Zone directory buckets (named `*--x-s3`).\n\n**GCS**\n- `--bucket` [`BLOB_BUCKET`] — required.\n- `--gcs-service-account-path` [`GCS_SERVICE_ACCOUNT_PATH`] — path to a service-account JSON key file.\n- `--gcs-service-account-key` [`GCS_SERVICE_ACCOUNT_KEY`] — the key contents inline. The *path* form takes precedence if both are set; if neither is set, application default credentials (ADC) are used.\n\n**uio-grpc**\n- `--endpoint` — the peer's public gRPC URL, e.g. `http:\u002F\u002Flocalhost:6334`. Required.\n- `--collection` [`QDRANT_COLLECTION`] — required.\n- `--shard-id` — defaults to `0`.\n- `--api-key` [`QDRANT_API_KEY`] — omit for an unauthenticated peer.\n\n> The peer must run with `QDRANT__FEATURE_FLAGS__WRITE_SEGMENT_MANIFEST=true`, otherwise the shard has no segment manifest and discovery fails.\n\n### Tuning flags (all backends)\n\n- `--cache-dir` — local mirror directory for the segment disk cache. Each remote block is fetched once and served locally afterwards. Defaults to a stable subdirectory of the system temp dir, so **the cache persists across runs** — delete it to force a cold read.\n- `--search-threads` — size of the shard's search thread pool (used to read segments in parallel at open, and to run searches). `0` derives it from the CPU count.\n- `--no-load-profile` — by default the shard is opened *for the specific request*, warming only the segment components that request will touch and leaving the rest cold. This flag disables that and warms everything per the persisted segment configs, like a long-lived deployment would. Use it when benchmarking steady-state behaviour rather than cold start.\n\n## Subcommands\n\n### `scroll` — paginate over points\n\n- `--offset \u003CID>` — start id, to resume a previous page. Accepts an integer or a UUID string.\n- `--order-by \u003CFIELD>` — order by a payload field instead of by id.\n\nPrints the records plus a `next_page_offset` line to feed back into `--offset`.\n\n### `search` — dense nearest-neighbour search\n\n- `--vector` — the query vector. Accepts a JSON array (`[0.1, 0.2, ...]`), a comma-separated list (`0.1,0.2,...`), or `@path` \u002F `@-` to read either form from a file or stdin. **If omitted, a random vector is used**, with its dimension read from the shard config once the shard is open — handy for a quick smoke test.\n- `--using \u003CNAME>` — which named vector to search. Omit for the default\u002Funnamed vector.\n- `--offset \u003CN>` — results to skip before collecting `--limit`. Default `0`.\n- `--score-threshold \u003CF>` — only return results scoring at least this.\n- `--hnsw-ef \u003CN>` — HNSW beam width. Larger is more accurate and slower.\n- `--exact` — search exhaustively, bypassing HNSW. Slow but exact; useful to check recall.\n\n### `search-sparse` — sparse nearest-neighbour search\n\n- `--vector` — **required**. Accepts a JSON object (`{\"indices\": [12, 700], \"values\": [0.4, 0.9]}`), a comma-separated list of `index:value` pairs (`12:0.4,700:0.9`), or `@path` \u002F `@-`. Indices need not be sorted.\n- `--using \u003CNAME>` — sparse vectors are named, so this is **usually required**. Omit only if the shard stores its sparse vector under the default (empty) name.\n- `--offset`, `--score-threshold`, `--exact` — as for `search` (`--exact` bypasses the sparse index).\n\n### Filtering and output (every subcommand)\n\n- `--filter \u003CJSON>` — an arbitrary payload filter in Qdrant's filter DSL (the `filter` field of a REST request). Curl `--data` style: a literal JSON string, `@path` to read from a file, or `@-` to read from stdin. Any condition the DSL can express works here, so there are no per-condition flags.\n- `--filter-key` \u002F `--filter-value` — shortcut for the common \"field equals value\" case. Must be given together, and are mutually exclusive with `--filter`. The value is parsed as an integer or boolean when it looks like one, otherwise as a string.\n- `--limit \u003CN>` — max points to return. Default `10`.\n- `--with-vectors` — include vectors in the output.\n\nResults print as one JSON object per line (`id`, `payload`, `vector`, plus `score` and `version` for searches).\n\n## Live reload — watching a leader's writes\n\nBoth flags keep the tool running after the first answer. Each iteration refreshes the shard from the backend, re-runs the **same** request, and prints a diff against the previous results:\n\n```\n+ {...}   point appeared\n- {...}   point disappeared\n~ {old} -> {new}   same id, changed content\n```\n\nA pure reordering of unchanged rows prints nothing (`no changes`). This is the fastest way to watch a leader writing into the same bucket, and to catch staleness or consistency bugs in the follower read path.\n\n- `--live-reload \u003CSECONDS>` — refresh on a timer (minimum 1).\n- `--live-reload-key` — refresh when you press Enter instead. Better when stepping through a debugger on the leader. Not compatible with `@-` (stdin) request arguments, since it reads stdin itself.\n\nThe two are mutually exclusive. A failed refresh is logged and retried on the next trigger — the shard keeps serving its previous state rather than dying.\n\n## Examples\n\nScroll with a JSON filter, against a local MinIO\u002FRustFS:\n\n```sh\ncargo run -p edge-shard-query -- \\\n    --backend  aws \\\n    --endpoint http:\u002F\u002Flocalhost:9000 \\\n    --bucket   test-bucket \\\n    --region   us-east-1 \\\n    --access-key rustfsadmin \\\n    --secret-key rustfsadmin \\\n    --prefix   collection\u002F0 \\\n    scroll \\\n    --filter '{\"must\":[{\"key\":\"city\",\"match\":{\"value\":\"London\"}}]}' \\\n    --limit  20\n```\n\nDense search on GCS, query vector from a file:\n\n```sh\ncargo run -p edge-shard-query -- \\\n    --backend gcs \\\n    --bucket  my-bucket \\\n    --gcs-service-account-path \u002Fpath\u002Fto\u002Fkey.json \\\n    --prefix  collection\u002F0 \\\n    search \\\n    --vector @query.json \\\n    --limit  5\n```\n\nSparse search (note `--using`, since sparse vectors are named):\n\n```sh\ncargo run -p edge-shard-query -- \\\n    --backend  aws \\\n    --endpoint http:\u002F\u002Flocalhost:9000 \\\n    --bucket   test-bucket \\\n    --prefix   collection\u002F0 \\\n    search-sparse \\\n    --using  text \\\n    --vector '{\"indices\": [12, 700, 5301], \"values\": [0.4, 0.9, 0.2]}' \\\n    --limit  5\n```\n\nRead straight from a running Qdrant peer — no object storage at all:\n\n```sh\ncargo run -p edge-shard-query -- \\\n    --backend    uio-grpc \\\n    --endpoint   http:\u002F\u002Flocalhost:6334 \\\n    --collection my_collection \\\n    --shard-id   0 \\\n    scroll \\\n    --limit 10\n```\n\nWatch a leader's writes propagate, re-running a filtered search every 2 seconds:\n\n```sh\ncargo run -p edge-shard-query -- \\\n    --backend  aws \\\n    --endpoint http:\u002F\u002Flocalhost:9000 \\\n    --bucket   test-bucket \\\n    --prefix   collection\u002F0 \\\n    --live-reload 2 \\\n    search \\\n    --filter-key city --filter-value London \\\n    --limit 20\n```\n\n## Troubleshooting\n\n- **Nothing found \u002F shard opens with 0 segments.** Check `--prefix` actually points at the shard root (the level holding `segments\u002F`), and that the leader wrote a segment manifest. For `uio-grpc`, the peer needs `QDRANT__FEATURE_FLAGS__WRITE_SEGMENT_MANIFEST=true`.\n- **Stale results.** The disk cache persists across runs by default. Delete `--cache-dir` (or the default temp subdirectory) to force a cold fetch.\n- **`--vector` rejected on `search-sparse`.** Sparse takes `{\"indices\": [...], \"values\": [...]}` or `12:0.4,700:0.9` — not a plain float array.\n- **Vector name not in shard config.** `--using` must name a vector that exists in the shard; with no `--using`, the default\u002Funnamed vector must exist.\n- **Credentials.** `--access-key` and `--secret-key` must be supplied together, or both omitted to fall back to the AWS default credential chain.\n",{"data":54,"body":55},{"name":4,"description":6},{"type":56,"children":57},"root",[58,65,96,101,108,219,247,268,274,292,429,441,492,526,532,537,545,722,730,801,808,885,902,908,965,971,983,1008,1028,1039,1160,1172,1283,1289,1388,1430,1436,1448,1458,1471,1503,1508,1514,1519,1735,1740,1880,1893,2051,2056,2179,2184,2345,2351,2489],{"type":59,"tag":60,"props":61,"children":62},"element","h1",{"id":4},[63],{"type":64,"value":4},"text",{"type":59,"tag":66,"props":67,"children":68},"p",{},[69,71,78,80,86,88,94],{"type":64,"value":70},"An experimental binary that opens a ",{"type":59,"tag":72,"props":73,"children":75},"code",{"className":74},[],[76],{"type":64,"value":77},"ReadOnlyEdgeShard",{"type":64,"value":79}," ",{"type":59,"tag":81,"props":82,"children":83},"strong",{},[84],{"type":64,"value":85},"directly over object storage",{"type":64,"value":87}," (S3\u002FS3-compatible or GCS) — or over a running Qdrant peer's ",{"type":59,"tag":72,"props":89,"children":91},{"className":90},[],[92],{"type":64,"value":93},"StorageRead",{"type":64,"value":95}," gRPC service — and runs a single read request against it.",{"type":59,"tag":66,"props":97,"children":98},{},[99],{"type":64,"value":100},"There is no Qdrant server in the loop for the object-storage backends. The tool reads segment files itself, through a local disk cache, so it is the fastest way to answer \"what does the data in this bucket actually contain?\" and to watch a leader's writes land.",{"type":59,"tag":102,"props":103,"children":105},"h2",{"id":104},"running-it",[106],{"type":64,"value":107},"Running it",{"type":59,"tag":109,"props":110,"children":115},"pre",{"className":111,"code":112,"language":113,"meta":114,"style":114},"language-sh shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","cargo run -p edge-shard-query -- \u003CCONNECTION FLAGS> \u003CSUBCOMMAND> \u003CSUBCOMMAND FLAGS>\n","sh","",[116],{"type":59,"tag":72,"props":117,"children":118},{"__ignoreMap":114},[119],{"type":59,"tag":120,"props":121,"children":124},"span",{"class":122,"line":123},"line",1,[125,131,137,142,147,152,158,163,168,174,179,183,188,193,197,201,206,210,214],{"type":59,"tag":120,"props":126,"children":128},{"style":127},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[129],{"type":64,"value":130},"cargo",{"type":59,"tag":120,"props":132,"children":134},{"style":133},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[135],{"type":64,"value":136}," run",{"type":59,"tag":120,"props":138,"children":139},{"style":133},[140],{"type":64,"value":141}," -p",{"type":59,"tag":120,"props":143,"children":144},{"style":133},[145],{"type":64,"value":146}," edge-shard-query",{"type":59,"tag":120,"props":148,"children":149},{"style":133},[150],{"type":64,"value":151}," --",{"type":59,"tag":120,"props":153,"children":155},{"style":154},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[156],{"type":64,"value":157}," \u003C",{"type":59,"tag":120,"props":159,"children":160},{"style":133},[161],{"type":64,"value":162},"CONNECTION",{"type":59,"tag":120,"props":164,"children":165},{"style":133},[166],{"type":64,"value":167}," FLAG",{"type":59,"tag":120,"props":169,"children":171},{"style":170},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[172],{"type":64,"value":173},"S",{"type":59,"tag":120,"props":175,"children":176},{"style":154},[177],{"type":64,"value":178},">",{"type":59,"tag":120,"props":180,"children":181},{"style":154},[182],{"type":64,"value":157},{"type":59,"tag":120,"props":184,"children":185},{"style":133},[186],{"type":64,"value":187},"SUBCOMMAN",{"type":59,"tag":120,"props":189,"children":190},{"style":170},[191],{"type":64,"value":192},"D",{"type":59,"tag":120,"props":194,"children":195},{"style":154},[196],{"type":64,"value":178},{"type":59,"tag":120,"props":198,"children":199},{"style":154},[200],{"type":64,"value":157},{"type":59,"tag":120,"props":202,"children":203},{"style":133},[204],{"type":64,"value":205},"SUBCOMMAND",{"type":59,"tag":120,"props":207,"children":208},{"style":133},[209],{"type":64,"value":167},{"type":59,"tag":120,"props":211,"children":212},{"style":170},[213],{"type":64,"value":173},{"type":59,"tag":120,"props":215,"children":216},{"style":154},[217],{"type":64,"value":218},">\n",{"type":59,"tag":66,"props":220,"children":221},{},[222,224,229,231,237,239,245],{"type":64,"value":223},"Connection flags must come ",{"type":59,"tag":81,"props":225,"children":226},{},[227],{"type":64,"value":228},"before",{"type":64,"value":230}," the subcommand; request flags come after it. For repeated use, build once (",{"type":59,"tag":72,"props":232,"children":234},{"className":233},[],[235],{"type":64,"value":236},"cargo build -p edge-shard-query --release",{"type":64,"value":238},") and call ",{"type":59,"tag":72,"props":240,"children":242},{"className":241},[],[243],{"type":64,"value":244},"target\u002Frelease\u002Fedge-shard-query",{"type":64,"value":246}," directly.",{"type":59,"tag":66,"props":248,"children":249},{},[250,252,258,260,266],{"type":64,"value":251},"Logging is on at ",{"type":59,"tag":72,"props":253,"children":255},{"className":254},[],[256],{"type":64,"value":257},"info",{"type":64,"value":259}," by default; raise it with ",{"type":59,"tag":72,"props":261,"children":263},{"className":262},[],[264],{"type":64,"value":265},"RUST_LOG=debug",{"type":64,"value":267},".",{"type":59,"tag":102,"props":269,"children":271},{"id":270},"choosing-a-backend",[272],{"type":64,"value":273},"Choosing a backend",{"type":59,"tag":66,"props":275,"children":276},{},[277,283,285,291],{"type":59,"tag":72,"props":278,"children":280},{"className":279},[],[281],{"type":64,"value":282},"--backend",{"type":64,"value":284}," selects where segments are read from. It defaults to ",{"type":59,"tag":72,"props":286,"children":288},{"className":287},[],[289],{"type":64,"value":290},"aws",{"type":64,"value":267},{"type":59,"tag":293,"props":294,"children":295},"table",{},[296,320],{"type":59,"tag":297,"props":298,"children":299},"thead",{},[300],{"type":59,"tag":301,"props":302,"children":303},"tr",{},[304,310,315],{"type":59,"tag":305,"props":306,"children":307},"th",{},[308],{"type":64,"value":309},"Backend",{"type":59,"tag":305,"props":311,"children":312},{},[313],{"type":64,"value":314},"What it reads",{"type":59,"tag":305,"props":316,"children":317},{},[318],{"type":64,"value":319},"Shard addressed by",{"type":59,"tag":321,"props":322,"children":323},"tbody",{},[324,358,389],{"type":59,"tag":301,"props":325,"children":326},{},[327,336,341],{"type":59,"tag":328,"props":329,"children":330},"td",{},[331],{"type":59,"tag":72,"props":332,"children":334},{"className":333},[],[335],{"type":64,"value":290},{"type":59,"tag":328,"props":337,"children":338},{},[339],{"type":64,"value":340},"AWS S3 or any S3-compatible store (MinIO, RustFS, LocalStack)",{"type":59,"tag":328,"props":342,"children":343},{},[344,350,352],{"type":59,"tag":72,"props":345,"children":347},{"className":346},[],[348],{"type":64,"value":349},"--bucket",{"type":64,"value":351}," + ",{"type":59,"tag":72,"props":353,"children":355},{"className":354},[],[356],{"type":64,"value":357},"--prefix",{"type":59,"tag":301,"props":359,"children":360},{},[361,370,375],{"type":59,"tag":328,"props":362,"children":363},{},[364],{"type":59,"tag":72,"props":365,"children":367},{"className":366},[],[368],{"type":64,"value":369},"gcs",{"type":59,"tag":328,"props":371,"children":372},{},[373],{"type":64,"value":374},"Google Cloud Storage",{"type":59,"tag":328,"props":376,"children":377},{},[378,383,384],{"type":59,"tag":72,"props":379,"children":381},{"className":380},[],[382],{"type":64,"value":349},{"type":64,"value":351},{"type":59,"tag":72,"props":385,"children":387},{"className":386},[],[388],{"type":64,"value":357},{"type":59,"tag":301,"props":390,"children":391},{},[392,401,413],{"type":59,"tag":328,"props":393,"children":394},{},[395],{"type":59,"tag":72,"props":396,"children":398},{"className":397},[],[399],{"type":64,"value":400},"uio-grpc",{"type":59,"tag":328,"props":402,"children":403},{},[404,406,411],{"type":64,"value":405},"A running Qdrant peer's ",{"type":59,"tag":72,"props":407,"children":409},{"className":408},[],[410],{"type":64,"value":93},{"type":64,"value":412}," gRPC service",{"type":59,"tag":328,"props":414,"children":415},{},[416,422,423],{"type":59,"tag":72,"props":417,"children":419},{"className":418},[],[420],{"type":64,"value":421},"--collection",{"type":64,"value":351},{"type":59,"tag":72,"props":424,"children":426},{"className":425},[],[427],{"type":64,"value":428},"--shard-id",{"type":59,"tag":430,"props":431,"children":433},"h3",{"id":432},"prefix-object-storage-only",[434,439],{"type":59,"tag":72,"props":435,"children":437},{"className":436},[],[438],{"type":64,"value":357},{"type":64,"value":440}," (object storage only)",{"type":59,"tag":66,"props":442,"children":443},{},[444,446,451,453,459,461,467,469,475,477,483,485,491],{"type":64,"value":445},"The key prefix inside the bucket that points at the ",{"type":59,"tag":81,"props":447,"children":448},{},[449],{"type":64,"value":450},"edge-shard root",{"type":64,"value":452}," — the directory containing ",{"type":59,"tag":72,"props":454,"children":456},{"className":455},[],[457],{"type":64,"value":458},"edge_config.json",{"type":64,"value":460}," and ",{"type":59,"tag":72,"props":462,"children":464},{"className":463},[],[465],{"type":64,"value":466},"segments\u002F",{"type":64,"value":468},". Empty means the bucket root. A shard for collection ",{"type":59,"tag":72,"props":470,"children":472},{"className":471},[],[473],{"type":64,"value":474},"foo",{"type":64,"value":476},", shard ",{"type":59,"tag":72,"props":478,"children":480},{"className":479},[],[481],{"type":64,"value":482},"0",{"type":64,"value":484}," typically lives at ",{"type":59,"tag":72,"props":486,"children":488},{"className":487},[],[489],{"type":64,"value":490},"foo\u002F0",{"type":64,"value":267},{"type":59,"tag":66,"props":493,"children":494},{},[495,497,502,504,510,512,517,519,524],{"type":64,"value":496},"An ",{"type":59,"tag":72,"props":498,"children":500},{"className":499},[],[501],{"type":64,"value":458},{"type":64,"value":503}," is ",{"type":59,"tag":505,"props":506,"children":507},"em",{},[508],{"type":64,"value":509},"not",{"type":64,"value":511}," required: segments are discovered from the leader's segment manifest, and the shard config is derived from the segments themselves. Leave ",{"type":59,"tag":72,"props":513,"children":515},{"className":514},[],[516],{"type":64,"value":357},{"type":64,"value":518}," empty for ",{"type":59,"tag":72,"props":520,"children":522},{"className":521},[],[523],{"type":64,"value":400},{"type":64,"value":525},", which addresses the shard by collection and shard id instead.",{"type":59,"tag":430,"props":527,"children":529},{"id":528},"connection-flags",[530],{"type":64,"value":531},"Connection flags",{"type":59,"tag":66,"props":533,"children":534},{},[535],{"type":64,"value":536},"All of these accept an environment variable as a fallback, shown in brackets.",{"type":59,"tag":66,"props":538,"children":539},{},[540],{"type":59,"tag":81,"props":541,"children":542},{},[543],{"type":64,"value":544},"AWS \u002F S3-compatible",{"type":59,"tag":546,"props":547,"children":548},"ul",{},[549,570,597,626,672,693],{"type":59,"tag":550,"props":551,"children":552},"li",{},[553,558,559,568],{"type":59,"tag":72,"props":554,"children":556},{"className":555},[],[557],{"type":64,"value":349},{"type":64,"value":79},{"type":59,"tag":120,"props":560,"children":561},{},[562],{"type":59,"tag":72,"props":563,"children":565},{"className":564},[],[566],{"type":64,"value":567},"BLOB_BUCKET",{"type":64,"value":569}," — bucket name, no scheme prefix. Required.",{"type":59,"tag":550,"props":571,"children":572},{},[573,579,580,589,591,596],{"type":59,"tag":72,"props":574,"children":576},{"className":575},[],[577],{"type":64,"value":578},"--endpoint",{"type":64,"value":79},{"type":59,"tag":120,"props":581,"children":582},{},[583],{"type":59,"tag":72,"props":584,"children":586},{"className":585},[],[587],{"type":64,"value":588},"S3_ENDPOINT",{"type":64,"value":590}," — custom S3 endpoint. Set for MinIO\u002FRustFS\u002FLocalStack; ",{"type":59,"tag":81,"props":592,"children":593},{},[594],{"type":64,"value":595},"omit for real AWS",{"type":64,"value":267},{"type":59,"tag":550,"props":598,"children":599},{},[600,606,607,616,618,624],{"type":59,"tag":72,"props":601,"children":603},{"className":602},[],[604],{"type":64,"value":605},"--region",{"type":64,"value":79},{"type":59,"tag":120,"props":608,"children":609},{},[610],{"type":59,"tag":72,"props":611,"children":613},{"className":612},[],[614],{"type":64,"value":615},"S3_REGION",{"type":64,"value":617}," — e.g. ",{"type":59,"tag":72,"props":619,"children":621},{"className":620},[],[622],{"type":64,"value":623},"us-east-1",{"type":64,"value":625},". Required for real AWS, optional for S3-compatible endpoints.",{"type":59,"tag":550,"props":627,"children":628},{},[629,635,636,645,647,653,654,663,665,670],{"type":59,"tag":72,"props":630,"children":632},{"className":631},[],[633],{"type":64,"value":634},"--access-key",{"type":64,"value":79},{"type":59,"tag":120,"props":637,"children":638},{},[639],{"type":59,"tag":72,"props":640,"children":642},{"className":641},[],[643],{"type":64,"value":644},"S3_ACCESS_KEY",{"type":64,"value":646}," \u002F ",{"type":59,"tag":72,"props":648,"children":650},{"className":649},[],[651],{"type":64,"value":652},"--secret-key",{"type":64,"value":79},{"type":59,"tag":120,"props":655,"children":656},{},[657],{"type":59,"tag":72,"props":658,"children":660},{"className":659},[],[661],{"type":64,"value":662},"S3_SECRET_KEY",{"type":64,"value":664}," — must be given ",{"type":59,"tag":81,"props":666,"children":667},{},[668],{"type":64,"value":669},"together",{"type":64,"value":671},". If both are omitted, the AWS default credential chain is used.",{"type":59,"tag":550,"props":673,"children":674},{},[675,681,682,691],{"type":59,"tag":72,"props":676,"children":678},{"className":677},[],[679],{"type":64,"value":680},"--session-token",{"type":64,"value":79},{"type":59,"tag":120,"props":683,"children":684},{},[685],{"type":59,"tag":72,"props":686,"children":688},{"className":687},[],[689],{"type":64,"value":690},"S3_SESSION_TOKEN",{"type":64,"value":692}," — for short-lived credentials.",{"type":59,"tag":550,"props":694,"children":695},{},[696,702,703,712,714,720],{"type":59,"tag":72,"props":697,"children":699},{"className":698},[],[700],{"type":64,"value":701},"--s3-express",{"type":64,"value":79},{"type":59,"tag":120,"props":704,"children":705},{},[706],{"type":59,"tag":72,"props":707,"children":709},{"className":708},[],[710],{"type":64,"value":711},"S3_EXPRESS",{"type":64,"value":713}," — for S3 Express One Zone directory buckets (named ",{"type":59,"tag":72,"props":715,"children":717},{"className":716},[],[718],{"type":64,"value":719},"*--x-s3",{"type":64,"value":721},").",{"type":59,"tag":66,"props":723,"children":724},{},[725],{"type":59,"tag":81,"props":726,"children":727},{},[728],{"type":64,"value":729},"GCS",{"type":59,"tag":546,"props":731,"children":732},{},[733,752,773],{"type":59,"tag":550,"props":734,"children":735},{},[736,741,742,750],{"type":59,"tag":72,"props":737,"children":739},{"className":738},[],[740],{"type":64,"value":349},{"type":64,"value":79},{"type":59,"tag":120,"props":743,"children":744},{},[745],{"type":59,"tag":72,"props":746,"children":748},{"className":747},[],[749],{"type":64,"value":567},{"type":64,"value":751}," — required.",{"type":59,"tag":550,"props":753,"children":754},{},[755,761,762,771],{"type":59,"tag":72,"props":756,"children":758},{"className":757},[],[759],{"type":64,"value":760},"--gcs-service-account-path",{"type":64,"value":79},{"type":59,"tag":120,"props":763,"children":764},{},[765],{"type":59,"tag":72,"props":766,"children":768},{"className":767},[],[769],{"type":64,"value":770},"GCS_SERVICE_ACCOUNT_PATH",{"type":64,"value":772}," — path to a service-account JSON key file.",{"type":59,"tag":550,"props":774,"children":775},{},[776,782,783,792,794,799],{"type":59,"tag":72,"props":777,"children":779},{"className":778},[],[780],{"type":64,"value":781},"--gcs-service-account-key",{"type":64,"value":79},{"type":59,"tag":120,"props":784,"children":785},{},[786],{"type":59,"tag":72,"props":787,"children":789},{"className":788},[],[790],{"type":64,"value":791},"GCS_SERVICE_ACCOUNT_KEY",{"type":64,"value":793}," — the key contents inline. The ",{"type":59,"tag":505,"props":795,"children":796},{},[797],{"type":64,"value":798},"path",{"type":64,"value":800}," form takes precedence if both are set; if neither is set, application default credentials (ADC) are used.",{"type":59,"tag":66,"props":802,"children":803},{},[804],{"type":59,"tag":81,"props":805,"children":806},{},[807],{"type":64,"value":400},{"type":59,"tag":546,"props":809,"children":810},{},[811,829,848,864],{"type":59,"tag":550,"props":812,"children":813},{},[814,819,821,827],{"type":59,"tag":72,"props":815,"children":817},{"className":816},[],[818],{"type":64,"value":578},{"type":64,"value":820}," — the peer's public gRPC URL, e.g. ",{"type":59,"tag":72,"props":822,"children":824},{"className":823},[],[825],{"type":64,"value":826},"http:\u002F\u002Flocalhost:6334",{"type":64,"value":828},". Required.",{"type":59,"tag":550,"props":830,"children":831},{},[832,837,838,847],{"type":59,"tag":72,"props":833,"children":835},{"className":834},[],[836],{"type":64,"value":421},{"type":64,"value":79},{"type":59,"tag":120,"props":839,"children":840},{},[841],{"type":59,"tag":72,"props":842,"children":844},{"className":843},[],[845],{"type":64,"value":846},"QDRANT_COLLECTION",{"type":64,"value":751},{"type":59,"tag":550,"props":849,"children":850},{},[851,856,858,863],{"type":59,"tag":72,"props":852,"children":854},{"className":853},[],[855],{"type":64,"value":428},{"type":64,"value":857}," — defaults to ",{"type":59,"tag":72,"props":859,"children":861},{"className":860},[],[862],{"type":64,"value":482},{"type":64,"value":267},{"type":59,"tag":550,"props":865,"children":866},{},[867,873,874,883],{"type":59,"tag":72,"props":868,"children":870},{"className":869},[],[871],{"type":64,"value":872},"--api-key",{"type":64,"value":79},{"type":59,"tag":120,"props":875,"children":876},{},[877],{"type":59,"tag":72,"props":878,"children":880},{"className":879},[],[881],{"type":64,"value":882},"QDRANT_API_KEY",{"type":64,"value":884}," — omit for an unauthenticated peer.",{"type":59,"tag":886,"props":887,"children":888},"blockquote",{},[889],{"type":59,"tag":66,"props":890,"children":891},{},[892,894,900],{"type":64,"value":893},"The peer must run with ",{"type":59,"tag":72,"props":895,"children":897},{"className":896},[],[898],{"type":64,"value":899},"QDRANT__FEATURE_FLAGS__WRITE_SEGMENT_MANIFEST=true",{"type":64,"value":901},", otherwise the shard has no segment manifest and discovery fails.",{"type":59,"tag":430,"props":903,"children":905},{"id":904},"tuning-flags-all-backends",[906],{"type":64,"value":907},"Tuning flags (all backends)",{"type":59,"tag":546,"props":909,"children":910},{},[911,929,947],{"type":59,"tag":550,"props":912,"children":913},{},[914,920,922,927],{"type":59,"tag":72,"props":915,"children":917},{"className":916},[],[918],{"type":64,"value":919},"--cache-dir",{"type":64,"value":921}," — local mirror directory for the segment disk cache. Each remote block is fetched once and served locally afterwards. Defaults to a stable subdirectory of the system temp dir, so ",{"type":59,"tag":81,"props":923,"children":924},{},[925],{"type":64,"value":926},"the cache persists across runs",{"type":64,"value":928}," — delete it to force a cold read.",{"type":59,"tag":550,"props":930,"children":931},{},[932,938,940,945],{"type":59,"tag":72,"props":933,"children":935},{"className":934},[],[936],{"type":64,"value":937},"--search-threads",{"type":64,"value":939}," — size of the shard's search thread pool (used to read segments in parallel at open, and to run searches). ",{"type":59,"tag":72,"props":941,"children":943},{"className":942},[],[944],{"type":64,"value":482},{"type":64,"value":946}," derives it from the CPU count.",{"type":59,"tag":550,"props":948,"children":949},{},[950,956,958,963],{"type":59,"tag":72,"props":951,"children":953},{"className":952},[],[954],{"type":64,"value":955},"--no-load-profile",{"type":64,"value":957}," — by default the shard is opened ",{"type":59,"tag":505,"props":959,"children":960},{},[961],{"type":64,"value":962},"for the specific request",{"type":64,"value":964},", warming only the segment components that request will touch and leaving the rest cold. This flag disables that and warms everything per the persisted segment configs, like a long-lived deployment would. Use it when benchmarking steady-state behaviour rather than cold start.",{"type":59,"tag":102,"props":966,"children":968},{"id":967},"subcommands",[969],{"type":64,"value":970},"Subcommands",{"type":59,"tag":430,"props":972,"children":974},{"id":973},"scroll-paginate-over-points",[975,981],{"type":59,"tag":72,"props":976,"children":978},{"className":977},[],[979],{"type":64,"value":980},"scroll",{"type":64,"value":982}," — paginate over points",{"type":59,"tag":546,"props":984,"children":985},{},[986,997],{"type":59,"tag":550,"props":987,"children":988},{},[989,995],{"type":59,"tag":72,"props":990,"children":992},{"className":991},[],[993],{"type":64,"value":994},"--offset \u003CID>",{"type":64,"value":996}," — start id, to resume a previous page. Accepts an integer or a UUID string.",{"type":59,"tag":550,"props":998,"children":999},{},[1000,1006],{"type":59,"tag":72,"props":1001,"children":1003},{"className":1002},[],[1004],{"type":64,"value":1005},"--order-by \u003CFIELD>",{"type":64,"value":1007}," — order by a payload field instead of by id.",{"type":59,"tag":66,"props":1009,"children":1010},{},[1011,1013,1019,1021,1027],{"type":64,"value":1012},"Prints the records plus a ",{"type":59,"tag":72,"props":1014,"children":1016},{"className":1015},[],[1017],{"type":64,"value":1018},"next_page_offset",{"type":64,"value":1020}," line to feed back into ",{"type":59,"tag":72,"props":1022,"children":1024},{"className":1023},[],[1025],{"type":64,"value":1026},"--offset",{"type":64,"value":267},{"type":59,"tag":430,"props":1029,"children":1031},{"id":1030},"search-dense-nearest-neighbour-search",[1032,1037],{"type":59,"tag":72,"props":1033,"children":1035},{"className":1034},[],[1036],{"type":64,"value":22},{"type":64,"value":1038}," — dense nearest-neighbour search",{"type":59,"tag":546,"props":1040,"children":1041},{},[1042,1091,1102,1127,1138,1149],{"type":59,"tag":550,"props":1043,"children":1044},{},[1045,1051,1053,1059,1061,1067,1069,1075,1076,1082,1084,1089],{"type":59,"tag":72,"props":1046,"children":1048},{"className":1047},[],[1049],{"type":64,"value":1050},"--vector",{"type":64,"value":1052}," — the query vector. Accepts a JSON array (",{"type":59,"tag":72,"props":1054,"children":1056},{"className":1055},[],[1057],{"type":64,"value":1058},"[0.1, 0.2, ...]",{"type":64,"value":1060},"), a comma-separated list (",{"type":59,"tag":72,"props":1062,"children":1064},{"className":1063},[],[1065],{"type":64,"value":1066},"0.1,0.2,...",{"type":64,"value":1068},"), or ",{"type":59,"tag":72,"props":1070,"children":1072},{"className":1071},[],[1073],{"type":64,"value":1074},"@path",{"type":64,"value":646},{"type":59,"tag":72,"props":1077,"children":1079},{"className":1078},[],[1080],{"type":64,"value":1081},"@-",{"type":64,"value":1083}," to read either form from a file or stdin. ",{"type":59,"tag":81,"props":1085,"children":1086},{},[1087],{"type":64,"value":1088},"If omitted, a random vector is used",{"type":64,"value":1090},", with its dimension read from the shard config once the shard is open — handy for a quick smoke test.",{"type":59,"tag":550,"props":1092,"children":1093},{},[1094,1100],{"type":59,"tag":72,"props":1095,"children":1097},{"className":1096},[],[1098],{"type":64,"value":1099},"--using \u003CNAME>",{"type":64,"value":1101}," — which named vector to search. Omit for the default\u002Funnamed vector.",{"type":59,"tag":550,"props":1103,"children":1104},{},[1105,1111,1113,1119,1121,1126],{"type":59,"tag":72,"props":1106,"children":1108},{"className":1107},[],[1109],{"type":64,"value":1110},"--offset \u003CN>",{"type":64,"value":1112}," — results to skip before collecting ",{"type":59,"tag":72,"props":1114,"children":1116},{"className":1115},[],[1117],{"type":64,"value":1118},"--limit",{"type":64,"value":1120},". Default ",{"type":59,"tag":72,"props":1122,"children":1124},{"className":1123},[],[1125],{"type":64,"value":482},{"type":64,"value":267},{"type":59,"tag":550,"props":1128,"children":1129},{},[1130,1136],{"type":59,"tag":72,"props":1131,"children":1133},{"className":1132},[],[1134],{"type":64,"value":1135},"--score-threshold \u003CF>",{"type":64,"value":1137}," — only return results scoring at least this.",{"type":59,"tag":550,"props":1139,"children":1140},{},[1141,1147],{"type":59,"tag":72,"props":1142,"children":1144},{"className":1143},[],[1145],{"type":64,"value":1146},"--hnsw-ef \u003CN>",{"type":64,"value":1148}," — HNSW beam width. Larger is more accurate and slower.",{"type":59,"tag":550,"props":1150,"children":1151},{},[1152,1158],{"type":59,"tag":72,"props":1153,"children":1155},{"className":1154},[],[1156],{"type":64,"value":1157},"--exact",{"type":64,"value":1159}," — search exhaustively, bypassing HNSW. Slow but exact; useful to check recall.",{"type":59,"tag":430,"props":1161,"children":1163},{"id":1162},"search-sparse-sparse-nearest-neighbour-search",[1164,1170],{"type":59,"tag":72,"props":1165,"children":1167},{"className":1166},[],[1168],{"type":64,"value":1169},"search-sparse",{"type":64,"value":1171}," — sparse nearest-neighbour search",{"type":59,"tag":546,"props":1173,"children":1174},{},[1175,1228,1245],{"type":59,"tag":550,"props":1176,"children":1177},{},[1178,1183,1185,1190,1192,1198,1200,1206,1208,1214,1215,1220,1221,1226],{"type":59,"tag":72,"props":1179,"children":1181},{"className":1180},[],[1182],{"type":64,"value":1050},{"type":64,"value":1184}," — ",{"type":59,"tag":81,"props":1186,"children":1187},{},[1188],{"type":64,"value":1189},"required",{"type":64,"value":1191},". Accepts a JSON object (",{"type":59,"tag":72,"props":1193,"children":1195},{"className":1194},[],[1196],{"type":64,"value":1197},"{\"indices\": [12, 700], \"values\": [0.4, 0.9]}",{"type":64,"value":1199},"), a comma-separated list of ",{"type":59,"tag":72,"props":1201,"children":1203},{"className":1202},[],[1204],{"type":64,"value":1205},"index:value",{"type":64,"value":1207}," pairs (",{"type":59,"tag":72,"props":1209,"children":1211},{"className":1210},[],[1212],{"type":64,"value":1213},"12:0.4,700:0.9",{"type":64,"value":1068},{"type":59,"tag":72,"props":1216,"children":1218},{"className":1217},[],[1219],{"type":64,"value":1074},{"type":64,"value":646},{"type":59,"tag":72,"props":1222,"children":1224},{"className":1223},[],[1225],{"type":64,"value":1081},{"type":64,"value":1227},". Indices need not be sorted.",{"type":59,"tag":550,"props":1229,"children":1230},{},[1231,1236,1238,1243],{"type":59,"tag":72,"props":1232,"children":1234},{"className":1233},[],[1235],{"type":64,"value":1099},{"type":64,"value":1237}," — sparse vectors are named, so this is ",{"type":59,"tag":81,"props":1239,"children":1240},{},[1241],{"type":64,"value":1242},"usually required",{"type":64,"value":1244},". Omit only if the shard stores its sparse vector under the default (empty) name.",{"type":59,"tag":550,"props":1246,"children":1247},{},[1248,1253,1255,1261,1262,1267,1269,1274,1276,1281],{"type":59,"tag":72,"props":1249,"children":1251},{"className":1250},[],[1252],{"type":64,"value":1026},{"type":64,"value":1254},", ",{"type":59,"tag":72,"props":1256,"children":1258},{"className":1257},[],[1259],{"type":64,"value":1260},"--score-threshold",{"type":64,"value":1254},{"type":59,"tag":72,"props":1263,"children":1265},{"className":1264},[],[1266],{"type":64,"value":1157},{"type":64,"value":1268}," — as for ",{"type":59,"tag":72,"props":1270,"children":1272},{"className":1271},[],[1273],{"type":64,"value":22},{"type":64,"value":1275}," (",{"type":59,"tag":72,"props":1277,"children":1279},{"className":1278},[],[1280],{"type":64,"value":1157},{"type":64,"value":1282}," bypasses the sparse index).",{"type":59,"tag":430,"props":1284,"children":1286},{"id":1285},"filtering-and-output-every-subcommand",[1287],{"type":64,"value":1288},"Filtering and output (every subcommand)",{"type":59,"tag":546,"props":1290,"children":1291},{},[1292,1333,1359,1377],{"type":59,"tag":550,"props":1293,"children":1294},{},[1295,1301,1303,1309,1311,1317,1319,1324,1326,1331],{"type":59,"tag":72,"props":1296,"children":1298},{"className":1297},[],[1299],{"type":64,"value":1300},"--filter \u003CJSON>",{"type":64,"value":1302}," — an arbitrary payload filter in Qdrant's filter DSL (the ",{"type":59,"tag":72,"props":1304,"children":1306},{"className":1305},[],[1307],{"type":64,"value":1308},"filter",{"type":64,"value":1310}," field of a REST request). Curl ",{"type":59,"tag":72,"props":1312,"children":1314},{"className":1313},[],[1315],{"type":64,"value":1316},"--data",{"type":64,"value":1318}," style: a literal JSON string, ",{"type":59,"tag":72,"props":1320,"children":1322},{"className":1321},[],[1323],{"type":64,"value":1074},{"type":64,"value":1325}," to read from a file, or ",{"type":59,"tag":72,"props":1327,"children":1329},{"className":1328},[],[1330],{"type":64,"value":1081},{"type":64,"value":1332}," to read from stdin. Any condition the DSL can express works here, so there are no per-condition flags.",{"type":59,"tag":550,"props":1334,"children":1335},{},[1336,1342,1343,1349,1351,1357],{"type":59,"tag":72,"props":1337,"children":1339},{"className":1338},[],[1340],{"type":64,"value":1341},"--filter-key",{"type":64,"value":646},{"type":59,"tag":72,"props":1344,"children":1346},{"className":1345},[],[1347],{"type":64,"value":1348},"--filter-value",{"type":64,"value":1350}," — shortcut for the common \"field equals value\" case. Must be given together, and are mutually exclusive with ",{"type":59,"tag":72,"props":1352,"children":1354},{"className":1353},[],[1355],{"type":64,"value":1356},"--filter",{"type":64,"value":1358},". The value is parsed as an integer or boolean when it looks like one, otherwise as a string.",{"type":59,"tag":550,"props":1360,"children":1361},{},[1362,1368,1370,1376],{"type":59,"tag":72,"props":1363,"children":1365},{"className":1364},[],[1366],{"type":64,"value":1367},"--limit \u003CN>",{"type":64,"value":1369}," — max points to return. Default ",{"type":59,"tag":72,"props":1371,"children":1373},{"className":1372},[],[1374],{"type":64,"value":1375},"10",{"type":64,"value":267},{"type":59,"tag":550,"props":1378,"children":1379},{},[1380,1386],{"type":59,"tag":72,"props":1381,"children":1383},{"className":1382},[],[1384],{"type":64,"value":1385},"--with-vectors",{"type":64,"value":1387}," — include vectors in the output.",{"type":59,"tag":66,"props":1389,"children":1390},{},[1391,1393,1399,1400,1406,1407,1413,1415,1421,1422,1428],{"type":64,"value":1392},"Results print as one JSON object per line (",{"type":59,"tag":72,"props":1394,"children":1396},{"className":1395},[],[1397],{"type":64,"value":1398},"id",{"type":64,"value":1254},{"type":59,"tag":72,"props":1401,"children":1403},{"className":1402},[],[1404],{"type":64,"value":1405},"payload",{"type":64,"value":1254},{"type":59,"tag":72,"props":1408,"children":1410},{"className":1409},[],[1411],{"type":64,"value":1412},"vector",{"type":64,"value":1414},", plus ",{"type":59,"tag":72,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":64,"value":1420},"score",{"type":64,"value":460},{"type":59,"tag":72,"props":1423,"children":1425},{"className":1424},[],[1426],{"type":64,"value":1427},"version",{"type":64,"value":1429}," for searches).",{"type":59,"tag":102,"props":1431,"children":1433},{"id":1432},"live-reload-watching-a-leaders-writes",[1434],{"type":64,"value":1435},"Live reload — watching a leader's writes",{"type":59,"tag":66,"props":1437,"children":1438},{},[1439,1441,1446],{"type":64,"value":1440},"Both flags keep the tool running after the first answer. Each iteration refreshes the shard from the backend, re-runs the ",{"type":59,"tag":81,"props":1442,"children":1443},{},[1444],{"type":64,"value":1445},"same",{"type":64,"value":1447}," request, and prints a diff against the previous results:",{"type":59,"tag":109,"props":1449,"children":1453},{"className":1450,"code":1452,"language":64},[1451],"language-text","+ {...}   point appeared\n- {...}   point disappeared\n~ {old} -> {new}   same id, changed content\n",[1454],{"type":59,"tag":72,"props":1455,"children":1456},{"__ignoreMap":114},[1457],{"type":64,"value":1452},{"type":59,"tag":66,"props":1459,"children":1460},{},[1461,1463,1469],{"type":64,"value":1462},"A pure reordering of unchanged rows prints nothing (",{"type":59,"tag":72,"props":1464,"children":1466},{"className":1465},[],[1467],{"type":64,"value":1468},"no changes",{"type":64,"value":1470},"). This is the fastest way to watch a leader writing into the same bucket, and to catch staleness or consistency bugs in the follower read path.",{"type":59,"tag":546,"props":1472,"children":1473},{},[1474,1485],{"type":59,"tag":550,"props":1475,"children":1476},{},[1477,1483],{"type":59,"tag":72,"props":1478,"children":1480},{"className":1479},[],[1481],{"type":64,"value":1482},"--live-reload \u003CSECONDS>",{"type":64,"value":1484}," — refresh on a timer (minimum 1).",{"type":59,"tag":550,"props":1486,"children":1487},{},[1488,1494,1496,1501],{"type":59,"tag":72,"props":1489,"children":1491},{"className":1490},[],[1492],{"type":64,"value":1493},"--live-reload-key",{"type":64,"value":1495}," — refresh when you press Enter instead. Better when stepping through a debugger on the leader. Not compatible with ",{"type":59,"tag":72,"props":1497,"children":1499},{"className":1498},[],[1500],{"type":64,"value":1081},{"type":64,"value":1502}," (stdin) request arguments, since it reads stdin itself.",{"type":59,"tag":66,"props":1504,"children":1505},{},[1506],{"type":64,"value":1507},"The two are mutually exclusive. A failed refresh is logged and retried on the next trigger — the shard keeps serving its previous state rather than dying.",{"type":59,"tag":102,"props":1509,"children":1511},{"id":1510},"examples",[1512],{"type":64,"value":1513},"Examples",{"type":59,"tag":66,"props":1515,"children":1516},{},[1517],{"type":64,"value":1518},"Scroll with a JSON filter, against a local MinIO\u002FRustFS:",{"type":59,"tag":109,"props":1520,"children":1522},{"className":111,"code":1521,"language":113,"meta":114,"style":114},"cargo run -p edge-shard-query -- \\\n    --backend  aws \\\n    --endpoint http:\u002F\u002Flocalhost:9000 \\\n    --bucket   test-bucket \\\n    --region   us-east-1 \\\n    --access-key rustfsadmin \\\n    --secret-key rustfsadmin \\\n    --prefix   collection\u002F0 \\\n    scroll \\\n    --filter '{\"must\":[{\"key\":\"city\",\"match\":{\"value\":\"London\"}}]}' \\\n    --limit  20\n",[1523],{"type":59,"tag":72,"props":1524,"children":1525},{"__ignoreMap":114},[1526,1554,1572,1590,1608,1626,1644,1661,1679,1692,1720],{"type":59,"tag":120,"props":1527,"children":1528},{"class":122,"line":123},[1529,1533,1537,1541,1545,1549],{"type":59,"tag":120,"props":1530,"children":1531},{"style":127},[1532],{"type":64,"value":130},{"type":59,"tag":120,"props":1534,"children":1535},{"style":133},[1536],{"type":64,"value":136},{"type":59,"tag":120,"props":1538,"children":1539},{"style":133},[1540],{"type":64,"value":141},{"type":59,"tag":120,"props":1542,"children":1543},{"style":133},[1544],{"type":64,"value":146},{"type":59,"tag":120,"props":1546,"children":1547},{"style":133},[1548],{"type":64,"value":151},{"type":59,"tag":120,"props":1550,"children":1551},{"style":170},[1552],{"type":64,"value":1553}," \\\n",{"type":59,"tag":120,"props":1555,"children":1557},{"class":122,"line":1556},2,[1558,1563,1568],{"type":59,"tag":120,"props":1559,"children":1560},{"style":133},[1561],{"type":64,"value":1562},"    --backend",{"type":59,"tag":120,"props":1564,"children":1565},{"style":133},[1566],{"type":64,"value":1567},"  aws",{"type":59,"tag":120,"props":1569,"children":1570},{"style":170},[1571],{"type":64,"value":1553},{"type":59,"tag":120,"props":1573,"children":1575},{"class":122,"line":1574},3,[1576,1581,1586],{"type":59,"tag":120,"props":1577,"children":1578},{"style":133},[1579],{"type":64,"value":1580},"    --endpoint",{"type":59,"tag":120,"props":1582,"children":1583},{"style":133},[1584],{"type":64,"value":1585}," http:\u002F\u002Flocalhost:9000",{"type":59,"tag":120,"props":1587,"children":1588},{"style":170},[1589],{"type":64,"value":1553},{"type":59,"tag":120,"props":1591,"children":1593},{"class":122,"line":1592},4,[1594,1599,1604],{"type":59,"tag":120,"props":1595,"children":1596},{"style":133},[1597],{"type":64,"value":1598},"    --bucket",{"type":59,"tag":120,"props":1600,"children":1601},{"style":133},[1602],{"type":64,"value":1603},"   test-bucket",{"type":59,"tag":120,"props":1605,"children":1606},{"style":170},[1607],{"type":64,"value":1553},{"type":59,"tag":120,"props":1609,"children":1611},{"class":122,"line":1610},5,[1612,1617,1622],{"type":59,"tag":120,"props":1613,"children":1614},{"style":133},[1615],{"type":64,"value":1616},"    --region",{"type":59,"tag":120,"props":1618,"children":1619},{"style":133},[1620],{"type":64,"value":1621},"   us-east-1",{"type":59,"tag":120,"props":1623,"children":1624},{"style":170},[1625],{"type":64,"value":1553},{"type":59,"tag":120,"props":1627,"children":1629},{"class":122,"line":1628},6,[1630,1635,1640],{"type":59,"tag":120,"props":1631,"children":1632},{"style":133},[1633],{"type":64,"value":1634},"    --access-key",{"type":59,"tag":120,"props":1636,"children":1637},{"style":133},[1638],{"type":64,"value":1639}," rustfsadmin",{"type":59,"tag":120,"props":1641,"children":1642},{"style":170},[1643],{"type":64,"value":1553},{"type":59,"tag":120,"props":1645,"children":1647},{"class":122,"line":1646},7,[1648,1653,1657],{"type":59,"tag":120,"props":1649,"children":1650},{"style":133},[1651],{"type":64,"value":1652},"    --secret-key",{"type":59,"tag":120,"props":1654,"children":1655},{"style":133},[1656],{"type":64,"value":1639},{"type":59,"tag":120,"props":1658,"children":1659},{"style":170},[1660],{"type":64,"value":1553},{"type":59,"tag":120,"props":1662,"children":1664},{"class":122,"line":1663},8,[1665,1670,1675],{"type":59,"tag":120,"props":1666,"children":1667},{"style":133},[1668],{"type":64,"value":1669},"    --prefix",{"type":59,"tag":120,"props":1671,"children":1672},{"style":133},[1673],{"type":64,"value":1674},"   collection\u002F0",{"type":59,"tag":120,"props":1676,"children":1677},{"style":170},[1678],{"type":64,"value":1553},{"type":59,"tag":120,"props":1680,"children":1682},{"class":122,"line":1681},9,[1683,1688],{"type":59,"tag":120,"props":1684,"children":1685},{"style":133},[1686],{"type":64,"value":1687},"    scroll",{"type":59,"tag":120,"props":1689,"children":1690},{"style":170},[1691],{"type":64,"value":1553},{"type":59,"tag":120,"props":1693,"children":1695},{"class":122,"line":1694},10,[1696,1701,1706,1711,1716],{"type":59,"tag":120,"props":1697,"children":1698},{"style":133},[1699],{"type":64,"value":1700},"    --filter",{"type":59,"tag":120,"props":1702,"children":1703},{"style":154},[1704],{"type":64,"value":1705}," '",{"type":59,"tag":120,"props":1707,"children":1708},{"style":133},[1709],{"type":64,"value":1710},"{\"must\":[{\"key\":\"city\",\"match\":{\"value\":\"London\"}}]}",{"type":59,"tag":120,"props":1712,"children":1713},{"style":154},[1714],{"type":64,"value":1715},"'",{"type":59,"tag":120,"props":1717,"children":1718},{"style":170},[1719],{"type":64,"value":1553},{"type":59,"tag":120,"props":1721,"children":1723},{"class":122,"line":1722},11,[1724,1729],{"type":59,"tag":120,"props":1725,"children":1726},{"style":133},[1727],{"type":64,"value":1728},"    --limit",{"type":59,"tag":120,"props":1730,"children":1732},{"style":1731},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1733],{"type":64,"value":1734},"  20\n",{"type":59,"tag":66,"props":1736,"children":1737},{},[1738],{"type":64,"value":1739},"Dense search on GCS, query vector from a file:",{"type":59,"tag":109,"props":1741,"children":1743},{"className":111,"code":1742,"language":113,"meta":114,"style":114},"cargo run -p edge-shard-query -- \\\n    --backend gcs \\\n    --bucket  my-bucket \\\n    --gcs-service-account-path \u002Fpath\u002Fto\u002Fkey.json \\\n    --prefix  collection\u002F0 \\\n    search \\\n    --vector @query.json \\\n    --limit  5\n",[1744],{"type":59,"tag":72,"props":1745,"children":1746},{"__ignoreMap":114},[1747,1774,1790,1806,1823,1839,1851,1868],{"type":59,"tag":120,"props":1748,"children":1749},{"class":122,"line":123},[1750,1754,1758,1762,1766,1770],{"type":59,"tag":120,"props":1751,"children":1752},{"style":127},[1753],{"type":64,"value":130},{"type":59,"tag":120,"props":1755,"children":1756},{"style":133},[1757],{"type":64,"value":136},{"type":59,"tag":120,"props":1759,"children":1760},{"style":133},[1761],{"type":64,"value":141},{"type":59,"tag":120,"props":1763,"children":1764},{"style":133},[1765],{"type":64,"value":146},{"type":59,"tag":120,"props":1767,"children":1768},{"style":133},[1769],{"type":64,"value":151},{"type":59,"tag":120,"props":1771,"children":1772},{"style":170},[1773],{"type":64,"value":1553},{"type":59,"tag":120,"props":1775,"children":1776},{"class":122,"line":1556},[1777,1781,1786],{"type":59,"tag":120,"props":1778,"children":1779},{"style":133},[1780],{"type":64,"value":1562},{"type":59,"tag":120,"props":1782,"children":1783},{"style":133},[1784],{"type":64,"value":1785}," gcs",{"type":59,"tag":120,"props":1787,"children":1788},{"style":170},[1789],{"type":64,"value":1553},{"type":59,"tag":120,"props":1791,"children":1792},{"class":122,"line":1574},[1793,1797,1802],{"type":59,"tag":120,"props":1794,"children":1795},{"style":133},[1796],{"type":64,"value":1598},{"type":59,"tag":120,"props":1798,"children":1799},{"style":133},[1800],{"type":64,"value":1801},"  my-bucket",{"type":59,"tag":120,"props":1803,"children":1804},{"style":170},[1805],{"type":64,"value":1553},{"type":59,"tag":120,"props":1807,"children":1808},{"class":122,"line":1592},[1809,1814,1819],{"type":59,"tag":120,"props":1810,"children":1811},{"style":133},[1812],{"type":64,"value":1813},"    --gcs-service-account-path",{"type":59,"tag":120,"props":1815,"children":1816},{"style":133},[1817],{"type":64,"value":1818}," \u002Fpath\u002Fto\u002Fkey.json",{"type":59,"tag":120,"props":1820,"children":1821},{"style":170},[1822],{"type":64,"value":1553},{"type":59,"tag":120,"props":1824,"children":1825},{"class":122,"line":1610},[1826,1830,1835],{"type":59,"tag":120,"props":1827,"children":1828},{"style":133},[1829],{"type":64,"value":1669},{"type":59,"tag":120,"props":1831,"children":1832},{"style":133},[1833],{"type":64,"value":1834},"  collection\u002F0",{"type":59,"tag":120,"props":1836,"children":1837},{"style":170},[1838],{"type":64,"value":1553},{"type":59,"tag":120,"props":1840,"children":1841},{"class":122,"line":1628},[1842,1847],{"type":59,"tag":120,"props":1843,"children":1844},{"style":133},[1845],{"type":64,"value":1846},"    search",{"type":59,"tag":120,"props":1848,"children":1849},{"style":170},[1850],{"type":64,"value":1553},{"type":59,"tag":120,"props":1852,"children":1853},{"class":122,"line":1646},[1854,1859,1864],{"type":59,"tag":120,"props":1855,"children":1856},{"style":133},[1857],{"type":64,"value":1858},"    --vector",{"type":59,"tag":120,"props":1860,"children":1861},{"style":133},[1862],{"type":64,"value":1863}," @query.json",{"type":59,"tag":120,"props":1865,"children":1866},{"style":170},[1867],{"type":64,"value":1553},{"type":59,"tag":120,"props":1869,"children":1870},{"class":122,"line":1663},[1871,1875],{"type":59,"tag":120,"props":1872,"children":1873},{"style":133},[1874],{"type":64,"value":1728},{"type":59,"tag":120,"props":1876,"children":1877},{"style":1731},[1878],{"type":64,"value":1879},"  5\n",{"type":59,"tag":66,"props":1881,"children":1882},{},[1883,1885,1891],{"type":64,"value":1884},"Sparse search (note ",{"type":59,"tag":72,"props":1886,"children":1888},{"className":1887},[],[1889],{"type":64,"value":1890},"--using",{"type":64,"value":1892},", since sparse vectors are named):",{"type":59,"tag":109,"props":1894,"children":1896},{"className":111,"code":1895,"language":113,"meta":114,"style":114},"cargo run -p edge-shard-query -- \\\n    --backend  aws \\\n    --endpoint http:\u002F\u002Flocalhost:9000 \\\n    --bucket   test-bucket \\\n    --prefix   collection\u002F0 \\\n    search-sparse \\\n    --using  text \\\n    --vector '{\"indices\": [12, 700, 5301], \"values\": [0.4, 0.9, 0.2]}' \\\n    --limit  5\n",[1897],{"type":59,"tag":72,"props":1898,"children":1899},{"__ignoreMap":114},[1900,1927,1942,1957,1972,1987,1999,2016,2040],{"type":59,"tag":120,"props":1901,"children":1902},{"class":122,"line":123},[1903,1907,1911,1915,1919,1923],{"type":59,"tag":120,"props":1904,"children":1905},{"style":127},[1906],{"type":64,"value":130},{"type":59,"tag":120,"props":1908,"children":1909},{"style":133},[1910],{"type":64,"value":136},{"type":59,"tag":120,"props":1912,"children":1913},{"style":133},[1914],{"type":64,"value":141},{"type":59,"tag":120,"props":1916,"children":1917},{"style":133},[1918],{"type":64,"value":146},{"type":59,"tag":120,"props":1920,"children":1921},{"style":133},[1922],{"type":64,"value":151},{"type":59,"tag":120,"props":1924,"children":1925},{"style":170},[1926],{"type":64,"value":1553},{"type":59,"tag":120,"props":1928,"children":1929},{"class":122,"line":1556},[1930,1934,1938],{"type":59,"tag":120,"props":1931,"children":1932},{"style":133},[1933],{"type":64,"value":1562},{"type":59,"tag":120,"props":1935,"children":1936},{"style":133},[1937],{"type":64,"value":1567},{"type":59,"tag":120,"props":1939,"children":1940},{"style":170},[1941],{"type":64,"value":1553},{"type":59,"tag":120,"props":1943,"children":1944},{"class":122,"line":1574},[1945,1949,1953],{"type":59,"tag":120,"props":1946,"children":1947},{"style":133},[1948],{"type":64,"value":1580},{"type":59,"tag":120,"props":1950,"children":1951},{"style":133},[1952],{"type":64,"value":1585},{"type":59,"tag":120,"props":1954,"children":1955},{"style":170},[1956],{"type":64,"value":1553},{"type":59,"tag":120,"props":1958,"children":1959},{"class":122,"line":1592},[1960,1964,1968],{"type":59,"tag":120,"props":1961,"children":1962},{"style":133},[1963],{"type":64,"value":1598},{"type":59,"tag":120,"props":1965,"children":1966},{"style":133},[1967],{"type":64,"value":1603},{"type":59,"tag":120,"props":1969,"children":1970},{"style":170},[1971],{"type":64,"value":1553},{"type":59,"tag":120,"props":1973,"children":1974},{"class":122,"line":1610},[1975,1979,1983],{"type":59,"tag":120,"props":1976,"children":1977},{"style":133},[1978],{"type":64,"value":1669},{"type":59,"tag":120,"props":1980,"children":1981},{"style":133},[1982],{"type":64,"value":1674},{"type":59,"tag":120,"props":1984,"children":1985},{"style":170},[1986],{"type":64,"value":1553},{"type":59,"tag":120,"props":1988,"children":1989},{"class":122,"line":1628},[1990,1995],{"type":59,"tag":120,"props":1991,"children":1992},{"style":133},[1993],{"type":64,"value":1994},"    search-sparse",{"type":59,"tag":120,"props":1996,"children":1997},{"style":170},[1998],{"type":64,"value":1553},{"type":59,"tag":120,"props":2000,"children":2001},{"class":122,"line":1646},[2002,2007,2012],{"type":59,"tag":120,"props":2003,"children":2004},{"style":133},[2005],{"type":64,"value":2006},"    --using",{"type":59,"tag":120,"props":2008,"children":2009},{"style":133},[2010],{"type":64,"value":2011},"  text",{"type":59,"tag":120,"props":2013,"children":2014},{"style":170},[2015],{"type":64,"value":1553},{"type":59,"tag":120,"props":2017,"children":2018},{"class":122,"line":1663},[2019,2023,2027,2032,2036],{"type":59,"tag":120,"props":2020,"children":2021},{"style":133},[2022],{"type":64,"value":1858},{"type":59,"tag":120,"props":2024,"children":2025},{"style":154},[2026],{"type":64,"value":1705},{"type":59,"tag":120,"props":2028,"children":2029},{"style":133},[2030],{"type":64,"value":2031},"{\"indices\": [12, 700, 5301], \"values\": [0.4, 0.9, 0.2]}",{"type":59,"tag":120,"props":2033,"children":2034},{"style":154},[2035],{"type":64,"value":1715},{"type":59,"tag":120,"props":2037,"children":2038},{"style":170},[2039],{"type":64,"value":1553},{"type":59,"tag":120,"props":2041,"children":2042},{"class":122,"line":1681},[2043,2047],{"type":59,"tag":120,"props":2044,"children":2045},{"style":133},[2046],{"type":64,"value":1728},{"type":59,"tag":120,"props":2048,"children":2049},{"style":1731},[2050],{"type":64,"value":1879},{"type":59,"tag":66,"props":2052,"children":2053},{},[2054],{"type":64,"value":2055},"Read straight from a running Qdrant peer — no object storage at all:",{"type":59,"tag":109,"props":2057,"children":2059},{"className":111,"code":2058,"language":113,"meta":114,"style":114},"cargo run -p edge-shard-query -- \\\n    --backend    uio-grpc \\\n    --endpoint   http:\u002F\u002Flocalhost:6334 \\\n    --collection my_collection \\\n    --shard-id   0 \\\n    scroll \\\n    --limit 10\n",[2060],{"type":59,"tag":72,"props":2061,"children":2062},{"__ignoreMap":114},[2063,2090,2106,2122,2139,2156,2167],{"type":59,"tag":120,"props":2064,"children":2065},{"class":122,"line":123},[2066,2070,2074,2078,2082,2086],{"type":59,"tag":120,"props":2067,"children":2068},{"style":127},[2069],{"type":64,"value":130},{"type":59,"tag":120,"props":2071,"children":2072},{"style":133},[2073],{"type":64,"value":136},{"type":59,"tag":120,"props":2075,"children":2076},{"style":133},[2077],{"type":64,"value":141},{"type":59,"tag":120,"props":2079,"children":2080},{"style":133},[2081],{"type":64,"value":146},{"type":59,"tag":120,"props":2083,"children":2084},{"style":133},[2085],{"type":64,"value":151},{"type":59,"tag":120,"props":2087,"children":2088},{"style":170},[2089],{"type":64,"value":1553},{"type":59,"tag":120,"props":2091,"children":2092},{"class":122,"line":1556},[2093,2097,2102],{"type":59,"tag":120,"props":2094,"children":2095},{"style":133},[2096],{"type":64,"value":1562},{"type":59,"tag":120,"props":2098,"children":2099},{"style":133},[2100],{"type":64,"value":2101},"    uio-grpc",{"type":59,"tag":120,"props":2103,"children":2104},{"style":170},[2105],{"type":64,"value":1553},{"type":59,"tag":120,"props":2107,"children":2108},{"class":122,"line":1574},[2109,2113,2118],{"type":59,"tag":120,"props":2110,"children":2111},{"style":133},[2112],{"type":64,"value":1580},{"type":59,"tag":120,"props":2114,"children":2115},{"style":133},[2116],{"type":64,"value":2117},"   http:\u002F\u002Flocalhost:6334",{"type":59,"tag":120,"props":2119,"children":2120},{"style":170},[2121],{"type":64,"value":1553},{"type":59,"tag":120,"props":2123,"children":2124},{"class":122,"line":1592},[2125,2130,2135],{"type":59,"tag":120,"props":2126,"children":2127},{"style":133},[2128],{"type":64,"value":2129},"    --collection",{"type":59,"tag":120,"props":2131,"children":2132},{"style":133},[2133],{"type":64,"value":2134}," my_collection",{"type":59,"tag":120,"props":2136,"children":2137},{"style":170},[2138],{"type":64,"value":1553},{"type":59,"tag":120,"props":2140,"children":2141},{"class":122,"line":1610},[2142,2147,2152],{"type":59,"tag":120,"props":2143,"children":2144},{"style":133},[2145],{"type":64,"value":2146},"    --shard-id",{"type":59,"tag":120,"props":2148,"children":2149},{"style":1731},[2150],{"type":64,"value":2151},"   0",{"type":59,"tag":120,"props":2153,"children":2154},{"style":170},[2155],{"type":64,"value":1553},{"type":59,"tag":120,"props":2157,"children":2158},{"class":122,"line":1628},[2159,2163],{"type":59,"tag":120,"props":2160,"children":2161},{"style":133},[2162],{"type":64,"value":1687},{"type":59,"tag":120,"props":2164,"children":2165},{"style":170},[2166],{"type":64,"value":1553},{"type":59,"tag":120,"props":2168,"children":2169},{"class":122,"line":1646},[2170,2174],{"type":59,"tag":120,"props":2171,"children":2172},{"style":133},[2173],{"type":64,"value":1728},{"type":59,"tag":120,"props":2175,"children":2176},{"style":1731},[2177],{"type":64,"value":2178}," 10\n",{"type":59,"tag":66,"props":2180,"children":2181},{},[2182],{"type":64,"value":2183},"Watch a leader's writes propagate, re-running a filtered search every 2 seconds:",{"type":59,"tag":109,"props":2185,"children":2187},{"className":111,"code":2186,"language":113,"meta":114,"style":114},"cargo run -p edge-shard-query -- \\\n    --backend  aws \\\n    --endpoint http:\u002F\u002Flocalhost:9000 \\\n    --bucket   test-bucket \\\n    --prefix   collection\u002F0 \\\n    --live-reload 2 \\\n    search \\\n    --filter-key city --filter-value London \\\n    --limit 20\n",[2188],{"type":59,"tag":72,"props":2189,"children":2190},{"__ignoreMap":114},[2191,2218,2233,2248,2263,2278,2295,2306,2333],{"type":59,"tag":120,"props":2192,"children":2193},{"class":122,"line":123},[2194,2198,2202,2206,2210,2214],{"type":59,"tag":120,"props":2195,"children":2196},{"style":127},[2197],{"type":64,"value":130},{"type":59,"tag":120,"props":2199,"children":2200},{"style":133},[2201],{"type":64,"value":136},{"type":59,"tag":120,"props":2203,"children":2204},{"style":133},[2205],{"type":64,"value":141},{"type":59,"tag":120,"props":2207,"children":2208},{"style":133},[2209],{"type":64,"value":146},{"type":59,"tag":120,"props":2211,"children":2212},{"style":133},[2213],{"type":64,"value":151},{"type":59,"tag":120,"props":2215,"children":2216},{"style":170},[2217],{"type":64,"value":1553},{"type":59,"tag":120,"props":2219,"children":2220},{"class":122,"line":1556},[2221,2225,2229],{"type":59,"tag":120,"props":2222,"children":2223},{"style":133},[2224],{"type":64,"value":1562},{"type":59,"tag":120,"props":2226,"children":2227},{"style":133},[2228],{"type":64,"value":1567},{"type":59,"tag":120,"props":2230,"children":2231},{"style":170},[2232],{"type":64,"value":1553},{"type":59,"tag":120,"props":2234,"children":2235},{"class":122,"line":1574},[2236,2240,2244],{"type":59,"tag":120,"props":2237,"children":2238},{"style":133},[2239],{"type":64,"value":1580},{"type":59,"tag":120,"props":2241,"children":2242},{"style":133},[2243],{"type":64,"value":1585},{"type":59,"tag":120,"props":2245,"children":2246},{"style":170},[2247],{"type":64,"value":1553},{"type":59,"tag":120,"props":2249,"children":2250},{"class":122,"line":1592},[2251,2255,2259],{"type":59,"tag":120,"props":2252,"children":2253},{"style":133},[2254],{"type":64,"value":1598},{"type":59,"tag":120,"props":2256,"children":2257},{"style":133},[2258],{"type":64,"value":1603},{"type":59,"tag":120,"props":2260,"children":2261},{"style":170},[2262],{"type":64,"value":1553},{"type":59,"tag":120,"props":2264,"children":2265},{"class":122,"line":1610},[2266,2270,2274],{"type":59,"tag":120,"props":2267,"children":2268},{"style":133},[2269],{"type":64,"value":1669},{"type":59,"tag":120,"props":2271,"children":2272},{"style":133},[2273],{"type":64,"value":1674},{"type":59,"tag":120,"props":2275,"children":2276},{"style":170},[2277],{"type":64,"value":1553},{"type":59,"tag":120,"props":2279,"children":2280},{"class":122,"line":1628},[2281,2286,2291],{"type":59,"tag":120,"props":2282,"children":2283},{"style":133},[2284],{"type":64,"value":2285},"    --live-reload",{"type":59,"tag":120,"props":2287,"children":2288},{"style":1731},[2289],{"type":64,"value":2290}," 2",{"type":59,"tag":120,"props":2292,"children":2293},{"style":170},[2294],{"type":64,"value":1553},{"type":59,"tag":120,"props":2296,"children":2297},{"class":122,"line":1646},[2298,2302],{"type":59,"tag":120,"props":2299,"children":2300},{"style":133},[2301],{"type":64,"value":1846},{"type":59,"tag":120,"props":2303,"children":2304},{"style":170},[2305],{"type":64,"value":1553},{"type":59,"tag":120,"props":2307,"children":2308},{"class":122,"line":1663},[2309,2314,2319,2324,2329],{"type":59,"tag":120,"props":2310,"children":2311},{"style":133},[2312],{"type":64,"value":2313},"    --filter-key",{"type":59,"tag":120,"props":2315,"children":2316},{"style":133},[2317],{"type":64,"value":2318}," city",{"type":59,"tag":120,"props":2320,"children":2321},{"style":133},[2322],{"type":64,"value":2323}," --filter-value",{"type":59,"tag":120,"props":2325,"children":2326},{"style":133},[2327],{"type":64,"value":2328}," London",{"type":59,"tag":120,"props":2330,"children":2331},{"style":170},[2332],{"type":64,"value":1553},{"type":59,"tag":120,"props":2334,"children":2335},{"class":122,"line":1681},[2336,2340],{"type":59,"tag":120,"props":2337,"children":2338},{"style":133},[2339],{"type":64,"value":1728},{"type":59,"tag":120,"props":2341,"children":2342},{"style":1731},[2343],{"type":64,"value":2344}," 20\n",{"type":59,"tag":102,"props":2346,"children":2348},{"id":2347},"troubleshooting",[2349],{"type":64,"value":2350},"Troubleshooting",{"type":59,"tag":546,"props":2352,"children":2353},{},[2354,2391,2408,2444,2467],{"type":59,"tag":550,"props":2355,"children":2356},{},[2357,2362,2364,2369,2371,2376,2378,2383,2385,2390],{"type":59,"tag":81,"props":2358,"children":2359},{},[2360],{"type":64,"value":2361},"Nothing found \u002F shard opens with 0 segments.",{"type":64,"value":2363}," Check ",{"type":59,"tag":72,"props":2365,"children":2367},{"className":2366},[],[2368],{"type":64,"value":357},{"type":64,"value":2370}," actually points at the shard root (the level holding ",{"type":59,"tag":72,"props":2372,"children":2374},{"className":2373},[],[2375],{"type":64,"value":466},{"type":64,"value":2377},"), and that the leader wrote a segment manifest. For ",{"type":59,"tag":72,"props":2379,"children":2381},{"className":2380},[],[2382],{"type":64,"value":400},{"type":64,"value":2384},", the peer needs ",{"type":59,"tag":72,"props":2386,"children":2388},{"className":2387},[],[2389],{"type":64,"value":899},{"type":64,"value":267},{"type":59,"tag":550,"props":2392,"children":2393},{},[2394,2399,2401,2406],{"type":59,"tag":81,"props":2395,"children":2396},{},[2397],{"type":64,"value":2398},"Stale results.",{"type":64,"value":2400}," The disk cache persists across runs by default. Delete ",{"type":59,"tag":72,"props":2402,"children":2404},{"className":2403},[],[2405],{"type":64,"value":919},{"type":64,"value":2407}," (or the default temp subdirectory) to force a cold fetch.",{"type":59,"tag":550,"props":2409,"children":2410},{},[2411,2427,2429,2435,2437,2442],{"type":59,"tag":81,"props":2412,"children":2413},{},[2414,2419,2421,2426],{"type":59,"tag":72,"props":2415,"children":2417},{"className":2416},[],[2418],{"type":64,"value":1050},{"type":64,"value":2420}," rejected on ",{"type":59,"tag":72,"props":2422,"children":2424},{"className":2423},[],[2425],{"type":64,"value":1169},{"type":64,"value":267},{"type":64,"value":2428}," Sparse takes ",{"type":59,"tag":72,"props":2430,"children":2432},{"className":2431},[],[2433],{"type":64,"value":2434},"{\"indices\": [...], \"values\": [...]}",{"type":64,"value":2436}," or ",{"type":59,"tag":72,"props":2438,"children":2440},{"className":2439},[],[2441],{"type":64,"value":1213},{"type":64,"value":2443}," — not a plain float array.",{"type":59,"tag":550,"props":2445,"children":2446},{},[2447,2452,2453,2458,2460,2465],{"type":59,"tag":81,"props":2448,"children":2449},{},[2450],{"type":64,"value":2451},"Vector name not in shard config.",{"type":64,"value":79},{"type":59,"tag":72,"props":2454,"children":2456},{"className":2455},[],[2457],{"type":64,"value":1890},{"type":64,"value":2459}," must name a vector that exists in the shard; with no ",{"type":59,"tag":72,"props":2461,"children":2463},{"className":2462},[],[2464],{"type":64,"value":1890},{"type":64,"value":2466},", the default\u002Funnamed vector must exist.",{"type":59,"tag":550,"props":2468,"children":2469},{},[2470,2475,2476,2481,2482,2487],{"type":59,"tag":81,"props":2471,"children":2472},{},[2473],{"type":64,"value":2474},"Credentials.",{"type":64,"value":79},{"type":59,"tag":72,"props":2477,"children":2479},{"className":2478},[],[2480],{"type":64,"value":634},{"type":64,"value":460},{"type":59,"tag":72,"props":2483,"children":2485},{"className":2484},[],[2486],{"type":64,"value":652},{"type":64,"value":2488}," must be supplied together, or both omitted to fall back to the AWS default credential chain.",{"type":59,"tag":2490,"props":2491,"children":2492},"style",{},[2493],{"type":64,"value":2494},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":2496,"total":2647},[2497,2504,2521,2536,2551,2564,2579,2592,2602,2613,2626,2636],{"slug":4,"name":4,"fn":5,"description":6,"org":2498,"tags":2499,"stars":23,"repoUrl":24,"updatedAt":25},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2500,2501,2502,2503],{"name":15,"slug":16,"type":13},{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"slug":2505,"name":2505,"fn":2506,"description":2507,"org":2508,"tags":2509,"stars":2518,"repoUrl":2519,"updatedAt":2520},"qdrant-advisor","diagnose and troubleshoot Qdrant deployments","Diagnose, troubleshoot, and advise on any Qdrant deployment by loading the latest official Qdrant skills live from skills.qdrant.tech. Use this whenever someone raises a Qdrant problem or question — slow or degraded search, high or growing memory \u002F OOM crashes, optimizer stuck or slow, indexing slowness, scaling and sharding decisions (node count, QPS, latency, multitenancy, vertical vs horizontal), poor or irrelevant search results, hybrid search and reranking, embedding-model migration, version upgrades and compatibility, monitoring and observability (Prometheus, Grafana, health checks, \u002Fmetrics, \u002Ftelemetry), deployment choices (local, Docker, self-hosted, Qdrant Cloud, embedded), or client-SDK questions (Python, TypeScript, Rust, Go, .NET, Java). Trigger especially when the context is clearly a Qdrant cluster, collection, or vector-search deployment. Always prefer this skill over answering from memory: it pulls current, authoritative guidance and only the relevant context.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2510,2511,2514,2517],{"name":18,"slug":19,"type":13},{"name":2512,"slug":2513,"type":13},"Debugging","debugging",{"name":2515,"slug":2516,"type":13},"Operations","operations",{"name":9,"slug":8,"type":13},197,"https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fskills","2026-07-16T06:02:56.675293",{"slug":2522,"name":2522,"fn":2523,"description":2524,"org":2525,"tags":2526,"stars":2518,"repoUrl":2519,"updatedAt":2535},"qdrant-clients-sdk","integrate Qdrant client SDKs","Qdrant provides client SDKs for various programming languages, allowing easy integration with Qdrant deployments.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2527,2530,2531,2532],{"name":2528,"slug":2529,"type":13},"API Development","api-development",{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2533,"slug":2534,"type":13},"SDK","sdk","2026-07-16T05:59:57.799789",{"slug":2537,"name":2537,"fn":2538,"description":2539,"org":2540,"tags":2541,"stars":2518,"repoUrl":2519,"updatedAt":2550},"qdrant-deployment-options","select Qdrant deployment options","Guides Qdrant deployment selection. Use when someone asks 'how to deploy Qdrant', 'Docker vs Cloud', 'local mode', 'embedded Qdrant', 'Qdrant EDGE', 'which deployment option', 'self-hosted vs cloud', or 'need lowest latency deployment'. Also use when choosing between deployment types for a new project.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2542,2543,2546,2549],{"name":18,"slug":19,"type":13},{"name":2544,"slug":2545,"type":13},"Deployment","deployment",{"name":2547,"slug":2548,"type":13},"Infrastructure","infrastructure",{"name":9,"slug":8,"type":13},"2026-07-19T05:38:33.324265",{"slug":2552,"name":2552,"fn":2553,"description":2554,"org":2555,"tags":2556,"stars":2518,"repoUrl":2519,"updatedAt":2563},"qdrant-edge","build applications with Qdrant Edge","Guides building on Qdrant Edge, the embedded in-process shard. Use when someone asks 'how to sync Edge with the server', 'keep a local shard in sync with Qdrant Cloud', 'BM25 or keyword search on Edge', 'hybrid search on Edge', 'embeddings on device', 'Edge snapshots', 'apply a partial snapshot', 'why is my Edge search empty after inserts', or is writing custom sync, BM25, or fusion code against qdrant-edge. Also use when deciding what Edge ships built-in versus what you must implement.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2557,2558,2561,2562],{"name":18,"slug":19,"type":13},{"name":2559,"slug":2560,"type":13},"Edge","edge",{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-07-16T06:01:19.179105",{"slug":2565,"name":2565,"fn":2566,"description":2567,"org":2568,"tags":2569,"stars":2518,"repoUrl":2519,"updatedAt":2578},"qdrant-horizontal-scaling","guide Qdrant horizontal scaling decisions","Diagnoses and guides Qdrant horizontal scaling decisions. Use when someone asks 'vertical or horizontal?', 'how many nodes?', 'how many shards?', 'how to add nodes', 'resharding', 'data doesn't fit', or 'need more capacity'. Also use when data growth outpaces current deployment.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2570,2573,2574,2575],{"name":2571,"slug":2572,"type":13},"Architecture","architecture",{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2576,"slug":2577,"type":13},"Scaling","scaling","2026-07-19T05:38:32.348551",{"slug":2580,"name":2580,"fn":2581,"description":2582,"org":2583,"tags":2584,"stars":2518,"repoUrl":2519,"updatedAt":2591},"qdrant-hybrid-search","implement hybrid search in Qdrant","Explains hybrid search in Qdrant. Use when someone asks 'how do I setup hybrid search?', 'how to combine keyword and semantic search?', 'sparse plus dense vectors?', 'missing keyword matches', 'how to combine results from multiple searches?' and 'combining multiple representations'",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2585,2588,2589,2590],{"name":2586,"slug":2587,"type":13},"AI Infrastructure","ai-infrastructure",{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-08-08T03:55:12.242691",{"slug":2593,"name":2593,"fn":2594,"description":2595,"org":2596,"tags":2597,"stars":2518,"repoUrl":2519,"updatedAt":2601},"qdrant-hybrid-search-combining","combine hybrid search scores in Qdrant","Fusing scores from multiple searches into a single ranked result (RRF, DBSF, custom fusion). Use when someone asks 'RRF or DBSF?', 'how to combine sparse and dense', 'how to combine scores from multiple searches?', 'custom fusion', or 'fusion is not producing good results'",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2598,2599,2600],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-07-16T06:01:49.401142",{"slug":2603,"name":2603,"fn":2604,"description":2605,"org":2606,"tags":2607,"stars":2518,"repoUrl":2519,"updatedAt":2612},"qdrant-hybrid-search-prefetches","configure hybrid search with prefetch queries","Constructing prefetch queries for hybrid retrieval, including sparse\u002Fdense and multi-field setups, and choosing a sparse embedding model. Use when someone asks 'dense and sparse in one search?', 'how to combine multiple fields for retrieval?', 'payloads or sparse vectors for lexical?', 'which sparse embedding model to use?', or 'BM25 vs SPLADE?'",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2608,2609,2610,2611],{"name":2528,"slug":2529,"type":13},{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-08-08T03:55:13.976497",{"slug":2614,"name":2614,"fn":2615,"description":2616,"org":2617,"tags":2618,"stars":2518,"repoUrl":2519,"updatedAt":2625},"qdrant-indexing-performance-optimization","optimize Qdrant indexing and data ingestion","Diagnoses and fixes slow Qdrant indexing and data ingestion. Use when someone reports 'uploads are slow', 'indexing takes forever', 'optimizer is stuck', 'HNSW build time too long', or 'data uploaded but search is bad'. Also use when optimizer status shows errors, segments won't merge, or indexing threshold questions arise.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2619,2620,2621,2624],{"name":18,"slug":19,"type":13},{"name":2512,"slug":2513,"type":13},{"name":2622,"slug":2623,"type":13},"Performance","performance",{"name":9,"slug":8,"type":13},"2026-07-19T05:38:36.321999",{"slug":2627,"name":2627,"fn":2628,"description":2629,"org":2630,"tags":2631,"stars":2518,"repoUrl":2519,"updatedAt":2635},"qdrant-memory-usage-optimization","optimize Qdrant memory usage","Diagnoses and reduces Qdrant memory usage. Use when someone reports 'memory too high', 'RAM keeps growing', 'node crashed', 'out of memory', 'memory leak', or asks 'why is memory usage so high?', 'how to reduce RAM?'. Also use when memory doesn't match calculations, quantization didn't help, or nodes crash during recovery.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2632,2633,2634],{"name":2512,"slug":2513,"type":13},{"name":2622,"slug":2623,"type":13},{"name":9,"slug":8,"type":13},"2026-08-08T03:55:12.975532",{"slug":2637,"name":2637,"fn":2638,"description":2639,"org":2640,"tags":2641,"stars":2518,"repoUrl":2519,"updatedAt":2646},"qdrant-minimize-latency","optimize Qdrant query latency","Guides Qdrant query latency optimization. Use when someone asks 'search is slow', 'how to reduce latency', 'p99 is too high', 'tail latency', 'single query too slow', 'how to make search faster', or 'latency spikes'.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2642,2643,2644,2645],{"name":18,"slug":19,"type":13},{"name":2512,"slug":2513,"type":13},{"name":2622,"slug":2623,"type":13},{"name":9,"slug":8,"type":13},"2026-08-08T03:55:18.969502",31,{"items":2649,"total":123},[2650],{"slug":4,"name":4,"fn":5,"description":6,"org":2651,"tags":2652,"stars":23,"repoUrl":24,"updatedAt":25},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2653,2654,2655,2656],{"name":15,"slug":16,"type":13},{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13}]