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
  • Example - With a Default Database

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 '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"));
}