qql-runtime (crate name qql)
Execute QQL: parse → prepare/embed → plan → batch → REST or gRPC or edge.
Proposition
One executor API. Backends implement QdrantOps. Plan IR is shared; gRPC is
not a second-class path — execute_grpc_route converts typed plan structs
to protobuf (query vectors / IDs without a JSON detour).
Stmt
→ prepare (schema USING kinds + embeddings)
→ plan() → PlannedOperation
→ REST: to_rest_route → JSON
→ gRPC: PlannedOperation → protobuf
→ Edge: in-process HNSW (qql-edge)
Quick start
use Arc;
use ;
use RestQdrant;
use HttpEmbedder;
let ops = Boxnew;
let embedder = new;
let exec = with_embedder;
exec.execute.await?;
Convenience: Executor::rest(url, api_key) / Executor::grpc(url, api_key).
QdrantOps
Unified backend trait (collections, indexes, execute_planned, query/update
batches). Implementations: RestQdrant, GrpcQdrant, EdgeQdrant (other crate).
| Backend | Port (typical) | Notes |
|---|---|---|
| REST | 6333 | OpenAPI JSON body |
| gRPC | 6334 | tonic + protos in proto/ |
| Edge | n/a | No cluster SHARD admin / GROUP BY / ACORN |
API key: REST header api-key; gRPC ApiKeyInterceptor.
Prepare order
- Schema topology → fill
USINGdense/sparse/multi - Embeddings (
qql-embed) — fail closed on unknown kind (QQL-VECTOR-KIND) - Upsert collection prep when needed
Multitenancy at execute time
-- Isolation in language + routing
QUERY TEXT 'q' FROM t USING dense
WHERE tenant_id = 'acme' SHARD 'acme' LIMIT 10;
Hosts should still inject_filter untrusted QQL. Routing is request-level
shard_key / ShardKeySelector on both transports.
Features
default = ["grpc", "rest"] — either can be disabled.
Docs
Test
# live Qdrant: