createdb

Nom

createdb -- cr�e une nouvelle base de donn�es PostgreSQL

Synopsis

createdb [option...] [nombase] [description]

Description

createdb cr�e une nouvelle base de donn�es PostgreSQL.

Normalement, l'utilisateur de la base de donn�es qui ex�cute cette commande devient le propri�taire de la nouvelle base de donn�es. N�anmoins, un propri�taire diff�rent peut �tre sp�cifi� via l'option -O si l'utilisateur ex�cutant a les droits appropri�s.

createdb est un emballage autour de la commande SQL CREATE DATABASE. Il n'y a pas de diff�rence effective entre la cr�ation de bases de donn�es via cet outil et d'autres m�thodes pour acc�der au serveur.

Options

createdb accepte les arguments suivant en ligne de commande :

nombase

Sp�cifie le nom de la base de donn�es � cr�er. Le nom doit �tre unique parmi toutes les bases de donn�es PostgreSQL de ce groupe. La valeur par d�faut est de cr�er une base de donn�es avec le m�me nom que l'utilisateur syst�me actuel.

description

Ceci sp�cifie en option un commentaire � associer avec la base de donn�es nouvellement cr��e.

-D emplacement
--location emplacement

Sp�cifie l'emplacement alternatif pour la base de donn�es. Voir aussi initlocation.

-e
--echo

Affiche les commandes que createdb g�n�re et envoie au serveur.

-E locale
--encoding locale

Sp�cifie le codage des caract�res � utiliser dans cette base de donn�es.

-O propri�taire
--owner propri�taire

Sp�cifie le propri�taire de la base de donn�es.

-q
--quiet

N'affiche pas de r�ponse.

-T mod�le
--template mod�le

Sp�cifie la base de donn�es mod�le � partir de laquelle construire cette base de donn�es.

Les options -D, -E, -O et -T correspondent aux options de la commande SQL sous-jacente CREATE DATABASE ; voir ici pour plus d'informations sur elles.

createdb accepte aussi les arguments suivant en ligne de commande pour les param�tres de connexion :

-h h�te
--host h�te

Sp�cifie le nom de l'h�te sur lequel le serveur est en cours d'ex�cution. Si la valeur commence avec un slash, elle est utilis�e comme r�pertoire du socket de domaine Unix.

-p port
--port port

Sp�cifie le port TCP ou l'extension du fichier socket de domaine Unix local sur lequel le serveur attend les connexions.

-U nomutilisateur
--username nomutilisateur

Nom de l'utilisateur � connecter

-W
--password

Force la demande du mot de passe.

Environnement

PGDATABASE

Si configur�, le nom de la base de donn�es � cr�er sauf si surcharg� sur la ligne de commande.

PGHOST
PGPORT
PGUSER

Param�tres de connexion par d�faut. PGUSER d�termine aussi le nom de la base de donn�es � cr�er s'il n'est pas sp�cifi� sur la ligne de commande ou par PGDATABASE.

Diagnostiques

En cas de difficult�, voir CREATE DATABASE et psql pour des discussions sur des probl�mes potentiels et des messages d'erreurs. Le serveur de la base de donn�es doit �tre en cours d'ex�cution sur l'h�te cible. De plus, tout param�tre de connexion et variable d'environnement par d�faut utilis� par la biblioth�que d'interface libpq sera appliqu�.

Exemples

Pour cr�er la base de donn�es demo en utilisant le serveur de bases de donn�es par d�faut :

$ createdb demo
CREATE DATABASE

La r�ponse est la m�me que celle re�ue si vous aviez lanc� la commande SQL CREATE DATABASE.

Pour cr�er la base de donn�es demo en utilisant le serveur sur l'h�te eden, port 5000, en utilisant le codage LATIN1 avec un regard � la commande sous-jacente :

$ createdb -p 5000 -h eden -E LATIN1 -e demo
CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'
CREATE DATABASE

Voir aussi

dropdb, CREATE DATABASE