Kiến Thức Linux

PostgreSQL Drop Database with Examples


PostgreSQL offers two command-line methods to drop a database – using the DROP DATABASE statement or a shell utility.

Removing unused databases is good practice and helps keep the workspace clean. However, keep in mind that deleting an existing PostgreSQL database removes all catalog entries and data for that database.

Continue reading to learn how to drop a database in PostgreSQL.

PostgreSQL DROP DATABASE with Examples



Important: ONLY the database owner can delete a database.

The first method to remove a PostgreSQL database is to use the following SQL statement:

DROP DATABASE <database name>;

The command removes the directory containing the database information and the catalog entries. Only the database owner can execute the DROP DATABASE command. If anyone is currently using the database, the command does not execute.

To see how DROP DATABASE works, do the following:

1. Open the terminal (CTRL+ALT+T).

2. Connect to PostgreSQL:

sudo -i -u postgres psql
sudo -i -u postgres psql terminal output

3. Create a database for the example:

create database example output

The terminal prints the executed statement.

4. List all the databases with:

postgres list databases example database

The database from the previous step shows up on the list.

5. Drop the database with:

drop database example

The output shows the executed statement.

6. List all databases again:


The example database no longer appears in the list.

IF Exists

The IF EXISTS option is open for all versions where DROP DATABASE is available. The full command syntax with the IF EXISTS option is as follows:

DROP DATABASE IF EXISTS <database name>;

The option first checks if a database exists before deleting it. If a database exists, the command drops the database. However, if a database doesn’t exist, the command prints an informative notice message.

To test how the command works, follow the steps below:

1. Create an example database:


2. Drop the database using the IF EXISTS option:

drop database if exists example

The result is identical to using DROP DATABASE if the database does exist.

3. The database is no longer available. Rerun the command to see the output:

drop database does not exist message

A notice message prints stating the database does not exist.

4. To see the difference between using IF EXISTS and omitting the option, run the following command:

drop database example error

Using DROP DATABASE without the IF EXISTS option on a non-existent database throws an error message.


The WITH (FORCE) option is available in PostgreSQL version 13 and higher.

The DROP DATABASE method won’t remove the database if it’s in use. If the database is in use, the terminal prints an error that a database session is open.

drop database error session

Add the WITH (FORCE) option to forcefully close the session and delete the database:

DROP DATABASE <database name> WITH (FORCE);
drop database with force

If possible, Postgres closes the user’s session and deletes the database forcefully.

The dropdb Utility

The dropdb shell utility is a wrapper for the DROP DATABASE command. Effectively, the two methods are identical. However, dropdb offers additional options including removing databases remotely.

The basic syntax is:

dropdb <connection parameters> <options> <database name>


The table below shows all the possible options when using the dropdb utility.

Option Type Description
Option Prints the commands that dropdb sends to the server.
Option Attempts to terminate all current connections before dropping the database.
Option Prompts verification before executing database deletion.
Option The console prints the utility version.
--if-exists Option Prints a notice instead of an error if the database does not exist.
Option Show the help menu.
-h <host>
Connection parameter Specifies the hostname of the machine where the server is running.
-p <port>
Connection parameter Specifies the TCP port where the server is listening.
-U <username>
--username  <username>
Connection parameter Connect as the specified user.
Connection parameter Never issue the password prompt. Useful for batch and script jobs when no user is present.
Connection parameter Force password prompt. Without the option, the server loses the connection attempt if a password is necessary.
--maintenance-db=<database name> Connection parameter The option specifies the database name connection.

For example, try the following command to see how dropdb works with the -i and -e options:

dropdb -i -e example

The program asks for confirmation before the deletion because of the -i tag.

dropdb -i -e example

Press y to confirm. The program prints the commands generated to the server. Because the database is non-existent, the program throws an error and exits.


After following the examples from this guide, you know how to drop a PostgreSQL database using two methods.

To learn how to drop a user in multiple ways, read our guide on how to delete Postgres user.

Next, consider learning about the different data types in PostgreSQL.

Đăng ký liền tay Nhận Ngay Bài Mới

Subscribe ngay

Cám ơn bạn đã đăng ký !

Lỗi đăng ký !

Add Comment

Click here to post a comment

Đăng ký liền tay
Nhận Ngay Bài Mới

Subscribe ngay

Cám ơn bạn đã đăng ký !

Lỗi đăng ký !