W3cubDocs

/RethinkDB Python

ReQL command: db_drop

Command syntax

r.db_drop(db_name) → object

Description

Drop a database. The database, all its tables, and corresponding data will be deleted.

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

  • dbs_dropped: always 1.
  • tables_dropped: the number of tables in the dropped database.
  • config_changes: a list containing one two-field object, old_val and new_val:
    • old_val: the database’s original config value.
    • new_val: always None.

If the given database does not exist, the command throws ReqlRuntimeError.

Example: Drop a database named ‘superheroes’.

r.db_drop('superheroes').run(conn)

{
    "config_changes": [
        {
            "old_val": {
                "id": "e4689cfc-e903-4532-a0e6-2d6797a43f07",
                "name": "superheroes"
            },
            "new_val": None
        }
    ],
    "tables_dropped": 3,
    "dbs_dropped": 1
}

Related commands

Get more help

Couldn't find what you were looking for?

© RethinkDB contributors
Licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License.
https://rethinkdb.com/api/python/db_drop/