DROP DATABASE

Complete guide to removing databases in MariaDB. Complete DROP DATABASE syntax with IF EXISTS, permissions, and recovery options for production use.

Syntax

DROP {DATABASE | SCHEMA} [IF EXISTS] db_name

Description

DROP DATABASE drops all tables in the database and deletes the database. Be very careful with this statement! To use DROP DATABASE, you need the DROP privilege on the database. DROP SCHEMA is a synonym for DROP DATABASE.

Important: When a database is dropped, user privileges on the database are not automatically dropped. See GRANT.

IF EXISTS

Use IF EXISTS to prevent an error from occurring for databases that do not exist. A NOTE is generated for each non-existent database when using IF EXISTS. See SHOW WARNINGS.

Atomic DDL

Current

MariaDB 10.6.1 supports Atomic DDL.DROP DATABASE is implemented as

LOOP OVER ALL tables
  DROP TABLE tbl

Each individual DROP TABLE is atomic while DROP DATABASE as a whole is crash-safe.

< 10.6.1

Examples

DROP DATABASE bufg;
Query OK, 0 rows affected (0.39 sec)

DROP DATABASE bufg;
ERROR 1008 (HY000): Can't drop database 'bufg'; database doesn't exist

 \W
SHOW warnings enabled.

DROP DATABASE IF EXISTS bufg;
Query OK, 0 rows affected, 1 warning (0.00 sec)
Note (Code 1008): Can't DROP DATABASE 'bufg'; DATABASE doesn't exist

See Also

• CREATE DATABASE

• ALTER DATABASE

• SHOW DATABASES

• Information Schema SCHEMATA Table

• SHOW CREATE DATABASE

_{This page is licensed: GPLv2, originally from fill_help_tables.sql}