What is a document store?

A document store is the main client API object, which establishes and manages the connection channel between an application and a database instance. It acts as the connection manager and also exposes methods to perform all operations that you can run against an associated server instance.

The document store object has single URL address that points to RavenDB server, however it can work against multiple databases that exists there.

There are three types of the document store objects, all of them implement common IDocumentStore interface:

  • DocumentStore acts against a remote server via HTTP requests,
  • EmbeddableDocumentStore interacts with a RavenDB embedded storage in a user's application by making direct calls to a database (see RavenDB Embedded mode)
  • ShardedDocumentStore works against a sharded RavenDB database (see How to setup sharding).

The document store ensures access to the following client API features: