Create a Database: General Flow
-
From Studio, the database creation options are:
- Regular database - see below.
- Encrypted database - see Encrypted Database.
- Create a database from a Backup copy - see From Backup.
- Create a database from a Previous RavenDB version database - see From Legacy File.
- Create a Sharded database - see the sharding Studio administration page.
-
In this page:
1. New Database
Create New Database Button
From the database list view, click the 'New database' button.
2. 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
Configure Replication
-
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). -
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. -
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
Configure Path
-
Set the directory path for the new database's data.
You can use any of the following options:- Write a full path
(e.g. Windows:C:/MyWork/MyDatabaseFolder
, Linux:/etc/MyWork/MyDatabaseFolder
)
The database's data will be stored at the specified location. - Write a relative path
(e.g.MyWork/MyDatabaseFolder
)
The database's data will be stored at the specified location inside your server's data directory (see info below). - Leave field empty
The database's data will be stored in theDatabases
directory inside your server's data directory.
- Write a full path
-
Information about the path you have chosen for your database's data.
- Node Tag: your server's cluster node tag - this indicates which server you're creating the new database on.
- Path: your database data's full path.
- Free Disk Space: the amount of available space on the local disk.
The Data Directory
- By default, the server's data directory is at
Server/RavenData
. This contains aDatabases
directory, which contains the data of the different databases on the server.
(e.g.Server/RavenData/Databases/MyDatabaseFolder
).
Learn more at Storage: Directory Structure. - The location of the server's data directory can be set in the
DataDir
configuration option. - A path can't start with:
$home
,~
, orappdrive:
.
5. Create
Create Database
Click 'Create' to finish.