dropdb

Name

dropdb -- supprime une base PostgreSQL

Synopsis

dropdb [options...] dbname

Entrées

-h, --host host

Spécifie le nom de la machine sur laquelle tourne le serveur. Si l'hôte débute par un slash, il est utilisé comme répertoire d'un socket de domaine Unix.

-p, --port port

Spécifie le port Internet TCP/IP ou l'extension de socket de domaine local Unix sur lequel le serveur est en attente de connexions.

-U, --username username

Nom de l'utilisateur pour la connexion

-W, --password

Force le mot-de-passe au prompt.

-e, --echo

Echo la requête que dropdb génère et l'envoie au serveur.

-q, --quiet

N'affiche pas de réponse.

-i, --interactive

Affiche un prompt de vérification avant de faire quoi que ce soit de destructif.

dbname

Spécifie le nom d'une base à supprimer. La base doit être une des bases PostgreSQL existantes dans l'installation.

Les options -h, -p, -U, -W, et -e sont passées au psql(1).

Sorties

DROP DATABASE

La base est supprimée.

dropdb: Database removal failed.

Quelque chose n'a pas fonctionné.

S'il y a une erreur de condition, le message d'erreur du serveur sera affiché. Voir DROP DATABASE et psql(1) pour les diverses possibilités.

Description

dropdb supprime une base PostgreSQL existante. L'utilisateur qui exécute cette commande doit être un superutilisateur ou le propriétaire de la base.

dropdb est un script shell qui contient la commande SQL DROP DATABASE via le PostgreSQL interactive terminal psql(1). Ainsi, il n'y a rien de spécial pour la suppression des bases avec l'une ou l'autre méthode. Ceci indique que psql doit être trouvé par le script et qu'un serveur de base tourne sur l'hôte cible. Ainsi, les placements par défaut et les variables d'environnement disponibles pour psql et la bibliothèque cliente libpq sont appliqués.

Utilisation

Pour supprimer une base demo sur le serveur par défaut :

$ dropdb demo
DROP DATABASE

Pour supprimer une base demo utilisant le serveur sur l'hôte eden, port 5000, avec vérification et un coup d'oeil sur la requête sous-jacente :

$ dropdb -p 5000 -h eden -i -e demo
Database "demo" will be permanently deleted.
Are you sure? (y/n) y
DROP DATABASE "demo"
DROP DATABASE