dropdb [ option ...] nom_bd
dropdb détruit une base de données PostgreSQL™. L'utilisateur qui exécute cette commande doit être superutilisateur ou le propriétaire de la base de données.
dropdb est un enrobage de la commande SQL DROP DATABASE. Il n'y a aucune différence réelle entre la suppression de bases de données avec cet outil et celles qui utilisent d'autres méthodes d'accès au serveur.
dropdb accepte les arguments suivants en ligne de commande :
Le nom de la base de données à supprimer.
Les commandes engendrées et envoyées au serveur par dropdb sont affichées.
Une confirmation préalable à toute destruction est exigée.
Aucune réponse n'est affichée.
dropdb accepte aussi les arguments suivants en ligne de commande pour les paramètres de connexion :
Le nom d'hôte de la machine sur laquelle le serveur fonctionne. Si la valeur débute par une barre oblique (/ ou slash), elle est utilisée comme répertoire de la socket de domaine Unix.
Le port TCP ou l'extension du fichier de la socket locale de domaine Unix sur laquelle le serveur attend les connexions.
Le nom de l'utilisateur utilisé pour la connexion.
Le mot de passe est obligatoirement demandé.
Paramètres de connexion par défaut
Cet outil, comme la plupart des autres outils PostgreSQL™, utilise aussi les variables d'environnement supportées par la bibliothèque libpq (voir Section 29.12, « Variables d'environnement »).
En cas de difficultés, il peut être utile de consulter DROP DATABASE et psql(1), sections présentant les problèmes éventuels et les messages d'erreur.
Le serveur de base de données doit fonctionner sur le serveur cible. Les paramètres de connexion éventuels et les variables d'environnement utilisés par la bibliothèque cliente libpq s'appliquent.
Détruire la base de données demo sur le serveur de bases de données par défaut :
$ dropdb demo DROP DATABASE
Détruire la base de données demo en utilisant le serveur hébergé sur l'hôte eden, qui écoute sur le port 5000, avec demande de confirmation et affichage de la commande 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