dropuser
dropuser — Supprimer un compte utilisateur PostgreSQL™
Synopsis
dropuser [
option
...] [
nomutilisateur
]
Description
dropuser supprime un utilisateur.
Seuls les superutilisateurs et les utilisateurs disposant du droit
CREATEROLE peuvent supprimer des
utilisateurs (seul un superutilisateur peut supprimer un
superutilisateur).
dropuser est un enrobage de la
commande SQL
DROP ROLE. Il n'y a
pas de différence réelle entre la suppression des utilisateurs à
l'aide de cet outil ou à l'aide d'autres méthodes d'accès au
serveur.
Options
dropuser accepte les arguments
suivants en ligne de commande :
-
nomutilisateur
-
Le nom de l'utilisateur PostgreSQL™ à supprimer. Un nom
est demandé s'il n'est pas fourni sur la ligne de commande.
-
-e,
--echo
-
Les commandes engendrées et envoyées au serveur par
dropuser sont affichées.
-
-i,
--interactive
-
Une confirmation est demandée avant la suppression effective
de l'utilisateur.
-
-q,
--quiet
-
Aucun affichage.
dropuser 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 lequel le serveur fonctionne.
Si la valeur commence par une barre oblique (/ ou slash),
elle est utilisée comme répertoire du socket de domaine Unix.
-
-p
port
,
--port
port
-
Le port TCP ou l'extension du fichier du socket local de
domaine Unix sur lequel le serveur attend les connexions.
-
-U
nomutilisateur
,
--username
nomutilisateur
-
Le nom de l'utilisateur utilisé pour la connexion.
-
-W,
--password
-
Un mot de passe est obligatoirement demandé.
Environnement
-
PGDATABASE,
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 ROLE 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
Supprimer l'utilisateur joe de la base de
données par défaut :
$ dropuser joe
DROP ROLE
Supprimer l'utilisateur joe sur 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 :
$ dropuser -p 5000 -h eden -i -e joe
Role "joe" will be permanently removed.
Are you sure? (y/n) y
DROP ROLE "joe"
DROP ROLE
droplang
