▲ Back to top

ReQL command: table_drop

Command syntax

db.table_drop(table_name) → object

Description

Drop a table. The table and all its data will be deleted.

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

  • tables_dropped: always 1.
  • config_changes: a list containing one two-field object, old_val and new_val:
    • old_val: the dropped table’s config value.
    • new_val: always nil.

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

Example: Drop a table named ‘dc_universe’.

r.db('test').table_drop('dc_universe').run(conn)

{
    :config_changes => [
        {
            :old_val => {
                :db => "test",
                :durability =>  "hard",
                :id => "20ea60d4-3b76-4817-8828-98a236df0297",
                :name => "dc_universe",
                :primary_key => "id",
                :shards => [
                    {
                        :primary_replica => "rethinkdb_srv1",
                        :replicas => [
                            "rethinkdb_srv1",
                            "rethinkdb_srv2"
                        ]
                    }
                ],
                :write_acks => "majority"
            },
            :new_val => nil
        }
    ],
    :tables_dropped => 1
}

Related commands

Get more help

Couldn't find what you were looking for?

Contribute: edit this page or open an issue