Create a Database: General Flow

1. New Database

Figure 1. Create New Database - Button

Create New Database Button

From the databases list view, click the 'New database' button.

2. Database Name

Figure 2. Create New Database - Database name

Enter Database Name

  • A database name can be any sequence of letters, digits, and characters that match the regex: [ _ \ - \ . ]+
  • A name cannot exceed 128 characters
  • Spaces are not allowed
  • If the name contains ., there must be some other character on both sides.
  • For example:
    • car_orders_2018
    • users.payments-2019

3. Configure Replication

Figure 3. Create New Database - Replication

Configure Replication

  1. Replication Factor:
    Set the number of nodes that will contain this database.
    The minimum required number is 1.
    The maximum number is the cluster size (number of nodes in the cluster).

  2. Dynamic Database Distribution
    Upon a node failure, and if this option is checked, the RavenDB server will automatically replicate the database content to another available node in the cluster, (one that doesn't already contain the database) so that replication factor is maintained.

  3. Setting Replication Nodes Manually
    Select the specific initial replication nodes from the cluster for the database to replicate to.
    If no node is checked, then the replication nodes will be selected randomly from the cluster.

4. Configure Path

Figure 4. Create New Database - Path

Configure Path

  • Set the directory path for database data.

  • You can use any of the following options:

    • Full path (e.g. Windows: C:/MyWork/MyDatabaseFolder, Linux: /etc/MyWork/MyDatabaseFolder )
      The database will be created in this physical location
    • Relative path (e.g. MyWork/MyDatabaseFolder)
      The database will be created under the DataDir folder
    • Leave field empty
      The Database will be created in Databases directory under the DataDir folder
  • Note:

    • The DataDir folder can be set in the settings.json configuration file (e.g. "DataDir": "RavenData").
    • If DataDir is Not specified in the configuration file, then the database will be created under the RavenDB binaries folder
      (where the RavenDB dlls are located).
    • A path can't start with: $home, '~' or 'appdrive:'

5. Create

Figure 5. Create New Database - Create

Create Database

Click 'Create' to finish.