You are currently browsing legacy 4.1 version of documentation. Click here to switch to the newest 4.2 version.

We can help you with migration to the latest RavenDB

Contact Us Now
see on GitHub

Client API: Setting up a Default Database


  • A default database can be set in the Document Store.
    The default database is used when accessing the Document Store methods without explicitly specifying a database.

  • You can pass a different database when accessing the Document Store methods.
    This database will override the default database for that method action only.
    The default database value itself will Not change.

  • When accessing the Document Store methods, an exception will be thrown if a default database is Not set and if No other database was explicitly passed.

  • In this page:


Example - Without a Default Database

using (IDocumentStore store = new DocumentStore
{
    Urls = new[] { "http://your_RavenDB_server_URL" }
    // Default database is not set
}.Initialize())
{
    // Specify the 'Northwind' database when opening a Session
    using (IDocumentSession session = store.OpenSession(database: "NorthWind"))
    {
        // Session will operate on the default 'Northwind' database
    }

    // Specify the 'Northwind' database when sending an Operation
    store.Maintenance.ForDatabase("Northwind").Send(new DeleteIndexOperation("NorthWindIndex"));
}

Example - With a Default Database

The default database is defined in the Document Store's Database property.

using (IDocumentStore store = new DocumentStore
{
    Urls = new[] { "http://your_RavenDB_server_URL" },
    // Default database is set to 'Northwind'
    Database = "Northwind"
}.Initialize())
{
    // Using the default database
    using (IDocumentSession northwindSession = store.OpenSession())
    {
        // Session will operate on the default 'Northwind' database
    }

    // Operation for default database
    store.Maintenance.Send(new DeleteIndexOperation("NorthWindIndex"));

    // Specify the 'AdventureWorks' database when opening a Session
    using (IDocumentSession adventureWorksSession = store.OpenSession(database: "AdventureWorks"))
    {
        // Session will operate on the specifed 'AdventureWorks' database
    }

    // Specify the 'AdventureWorks' database when sending an Operation
    store.Maintenance.ForDatabase("AdventureWorks").Send(new DeleteIndexOperation("AdventureWorksIndex"));
}