dropdb
dropdb — Supprimer une base de données PostgreSQL™
Synopsis
dropdb [
option
...]
nom_bd
Description
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.
Options
dropdb accepte les arguments
suivants en ligne de commande :
-
nom_bd
-
Le nom de la base de données à supprimer.
-
-e,
--echo
-
Les commandes engendrées et envoyées au serveur par
dropdb sont affichées.
-
-i,
--interactive
-
Une confirmation préalable à toute destruction est exigée.
-
-q,
--quiet
-
Aucune réponse n'est affichée.
dropdb accepte aussi les arguments
suivants en ligne de commande pour les paramètres de connexion :
-
-h
hôte
,
--host
hôte
-
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.
-
-p
port
,
--port
port
-
Le port TCP ou l'extension du fichier de la socket locale de
domaine Unix sur laquelle le serveur attend les connexions.
-
-U
nomutilisateur
,
--username
nomutilisateur
-
Le nom de l'utilisateur utilisé pour la connexion.
-
-W,
--password
-
Le mot de passe est obligatoirement demandé.
Environnement
-
PGHOST,
PGPORT,
PGUSER
-
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 »).
Diagnostiques
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.
Exemples
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
createuser
