Back to top

ReQL command: dbCreate

Command syntax

r.dbCreate(dbName) → object


Create a database. A RethinkDB database is a collection of tables, similar to relational databases.

If successful, the command returns an object with two fields:

  • dbs_created: always 1.
  • config_changes: a list containing one object with two fields, old_val and new_val:
    • old_val: always null.
    • new_val: the database’s new config value.

If a database with the same name already exists, the command throws ReqlRuntimeError.

Note: Only alphanumeric characters, hyphens and underscores are valid for the database name.

Example: Create a database named ‘superheroes’.

> r.dbCreate('superheroes').run(conn, callback);
// Result passed to callback
    "config_changes": [
            "new_val": {
                "id": "e4689cfc-e903-4532-a0e6-2d6797a43f07",
                "name": "superheroes"
            "old_val": null
    "dbs_created": 1

Get more help

Couldn't find what you were looking for?