Documentation PostgreSQL 7.2
<<< PreviousNext >>>

createuser

Name

createuser -- définit un nouveau compte utilisateur PostgreSQL

Synopsis

createuser [options...] [username]

Entrées

-h, --host host

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

-p, --port port

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

-e, --echo

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

-q, --quiet

N'affiche pas de réponse.

-d, --createdb

Permet au nouvel utilisateur de créer des bases.

-D, --no-createdb

Interdit au nouvel utilisateur de créer des bases.

-a, --adduser

Permet au nouvel utilisateur de créer d'autres utilisateurs.

-A, --no-adduser

Interdit au nouvel utilisateur de créer d'autres utilisateurs.

-P, --pwprompt

Si fournit, createuser affichera un prompt pour le mot-de-passe du nouvel utilisateur. Ce n'est pas nécessaire si vous ne prévoyez pas d'utiliser l'authentification par mot-de-passe.

-i, --sysid uid

Permet de prendre un ID utilisateur non par défaut pour le nouvel utilisateur. Ce n'est pas nécessaire, mais certaines personnes l'utilisent.

-E, --encrypted

Crypte le mot-de-passe utilisateur stocké dans la base. Si non spécifié, celui par défaut est utilisé.

-N, --unencrypted

Ne crypte pas le mot-de-passe utilisateur stocké dans la base. Si non spécifié, celui par défaut est utilisé.

username

Spécifie le nom de l'utilisateur PostgreSQL à créer. Ce nom doit être unique parmi les utilisateur PostgreSQL.

il vous sera demandé un nom ou autre information oubliée si non spécifié dans la ligne de commande.

Les options -h, -p, et -e, sont passées à psql(1). Les options psql -U et -W sont également disponibles, mais leur usage peut être confondu dans ce contexte.

Sorties

CREATE USER

Tout est correct.

createuser: creation of user "username" failed

Quelque chose n'est pas correct. L'utilisateur n'est pas créé.

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

Description

createuser crée un nouvel utilisateur PostgreSQL. Seuls les utilisateurs avec usesuper placé dans la table pg_shadow peuvent créer de nouveaux utilisateurs PostgreSQL.

createuser est un script shell comprenant la commande SQL CREATE USER via le PostgreSQL interactive terminal psql(1). Ainsi, il n'y a rien de spécial pour créer des utilisateurs via l'une ou l'autre méthode. Ceci indique que le psql doit être trouvé par le script et qu'un serveur de base tourne sur l'hôte cible. Ainsi, le placement par défaut et variable d'environnement disponible pour psql et la bibliothèque cliente libpq sont appliqués.

Utilisation

Pour créer un utilisateur joe sur le serveur de base par défaut : 

$ createuser joe
Is the new user allowed to create databases? (y/n) n
Shall the new user be allowed to create more new users? (y/n) n
CREATE USER

Pour créer le même utilisateur joe en utilisant le serveur sur l'hôte eden, port 5000, en évitant les prompts et jettant un regard sur la requête sous-jacente : 

$ createuser -p 5000 -h eden -D -A -e joe
CREATE USER "joe" NOCREATEDB NOCREATEUSER
CREATE USER

<<< PreviousHomeNext >>>
createlangUpdropdb