PostgreSQL - DROP Database



In this chapter, we will discuss how to delete the database in PostgreSQL. There are two options to delete a database −

  • Using DROP DATABASE, an SQL command.
  • Using dropdb a command-line executable.
Be careful before using this operation because deleting an existing database would result in loss of complete information stored in the database.

Using DROP DATABASE

This command drops a database. It removes the catalog entries for the database and deletes the directory containing the data. It can only be executed by the database owner. This command cannot be executed while you or anyone else is connected to the target database (connect to postgres or any other database to issue this command).

Syntax

The syntax for DROP DATABASE is given below −

DROP DATABASE [ IF EXISTS ] name

Parameters

The table lists the parameters with their descriptions.

S. No. Parameter & Description
1

IF EXISTS

Do not throw an error if the database does not exist. A notice is issued in this case.

2

name

The name of the database to remove.

We cannot drop a database that has any open connections, including our own connection from psql or pgAdmin III. We must switch to another database or template1 if we want to delete the database we are currently connected to. Thus, it might be more convenient to use the program dropdb instead, which is a wrapper around this command.

Example

The following is a simple example, which will delete testdb from your PostgreSQL schema −

postgres=# DROP DATABASE testdb;
postgres-# 

Using dropdb Command

PostgresSQL command line executable dropdb is a command-line wrapper around the SQL command DROP DATABASE. There is no effective difference between dropping databases via this utility and via other methods for accessing the server. dropdb destroys an existing PostgreSQL database. The user, who executes this command must be a database super user or the owner of the database.

Syntax

The syntax for dropdb is as shown below −

dropdb  [option...] dbname

Parameters

The following table lists the parameters with their descriptions

S. No. Parameter & Description
1

dbname

The name of a database to be deleted.

2

option

command-line arguments, which dropdb accepts.

Options

The following table lists the command-line arguments dropdb accepts −

S. No. Option & Description
1

-e

Shows the commands being sent to the server.

2

-i

Issues a verification prompt before doing anything destructive.

3

-V

Print the dropdb version and exit.

4

--if-exists

Do not throw an error if the database does not exist. A notice is issued in this case.

5

--help

Show help about dropdb command-line arguments, and exit.

6

-h host

Specifies the host name of the machine on which the server is running.

7

-p port

Specifies the TCP port or the local UNIX domain socket file extension on which the server is listening for connections.

8

-U username

User name to connect as.

9

-w

Never issue a password prompt.

10

-W

Force dropdb to prompt for a password before connecting to a database.

11

--maintenance-db=dbname

Specifies the name of the database to connect to in order to drop the target database.

Example

The following example demonstrates deleting a database from OS command prompt −

dropdb -h localhost -p 5432 -U postgress testdb
Password for user postgress: ****

The above command drops the database testdb. Here, I have used the postgres (found under the pg_roles of template1) username to drop the database.

Advertisements