Namespace
StorageA namespace is a logical partition in Pinecone that groups vectors separately. Namespaces allow you to scope vector search to a subset of vectors—for example, by tenant, project, or knowledge base. DocLD uses Pinecone namespaces to organize embedding vectors and scope queries.
How Namespaces Work
| Concept | Description |
|---|---|
| Partition | Namespaces are partitions within a single Pinecone index |
| Scope | Queries can target a namespace or multiple namespaces |
| Isolation | Vectors in different namespaces are not mixed unless queried together |
| Metadata | Namespace can be used with metadata for flexible scoping |
When you upsert vectors, you specify a namespace. When you query, you specify which namespace(s) to search. DocLD manages namespaces based on your knowledge base and deployment configuration.
DocLD Namespace Usage
- Per knowledge base — DocLD may use namespaces to scope search by knowledge base
- Per tenant — Multi-tenant deployments can use namespaces to isolate tenant data
- Single index — A single Pinecone index can hold multiple namespaces
Namespace choice affects query latency and isolation. DocLD abstracts namespace details for most use cases; advanced configurations may expose namespace options.
Related Concepts
Namespaces partition Pinecone indexes. The index stores embeddings; namespaces scope which vectors are queried. Knowledge bases determine document scope for vector search.