Documentation PostgreSQL 7.2
<<< PreviousNext >>>

createdb

Name

createdb -- crée une nouvelle base PostgreSQL

Synopsis

createdb [options...] [dbname] [description]

Entrées

-h, --host host

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

-p, --port port

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

-U, --username username

nom d'utilisateur pour se connecter.

-W, --password

Force le mot de passe au prompt..

-e, --echo

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

-q, --quiet

N'affiche pas de réponse.

-D, --location datadir

Spécifie la localisation alternative de la base. Voir aussi initlocation(1).

-T, --template template

Spécifie la base gabarit avec laquelle construire la base.

-E, --encoding encoding

Spécifie le schéma d'encodage des caractères à utiliser dans la base.

dbname

Spécifie le nom de la base à créer. Le nom doit être unique parmi tous les noms de bases dans cette installation de PostgreSQL. Par défaut il est créé une base ayant le même nom que l'utilisateur système courant.

description

Spécifie optionnellement un commentaire à associer avec la base nouvellement créée.

Les options -h, -p, -U, -W, et -e sont passées à psql(1). Les options -D, -T, et -E sont converties en options de la commande SQL CREATE DATABASE; voir là pour plus d'information.

Sorties

CREATE DATABASE

La base est créée avec succès.

createdb: Database creation failed.

(Ce qui veut tout dire).

createdb: Comment creation failed. (Database was created.)

Le commentaire/description pour la base ne peut pas être créé. La base elle-même à déja été créée. Vous pouvez utiliser la commande SQL COMMENT ON DATABASE pour créer la commentaire plus tard.

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

Description

createdb crée une nouvelle base PostgreSQL. L'utilisateur qui exécute cette commande devient le propriétaire de la base.

createdb est un script shell qui comprend la commande SQL CREATE DATABASE via le terminal interactif PostgreSQL psql(1). Ainsi, il n'y a rien de spécial pour créer des bases via l'une ou l'autre méthode. Ceci indique que la programme psql doit être trouvé par le script et qu'un serveur de base doit tourner sur le port cible. Ainsi, le placement par défaut et les variables d'environnement pour psql et la bibliothèque cliente libpq seront appliqués.

Utilisation

Pour créer une base demo en utilisant le serveur par défaut : 

$ createdb demo
CREATE DATABASE
La réponse est la même que vous auriez obtenue si vous aviez lancé la commande SQL CREATE DATABASE.

Pour créer la base demo en utilisant le serveur sur l'hôte eden, port 5000, utilisant le schéma d'encodage LATIN1 avec un regard à la requête sous-jacente : 

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

<<< PreviousHomeNext >>>
Applications clientes PostgreSQLUpcreatelang