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

Spécifie un commentaire à associer avec la base de données nouvellement créée.

-D espace_logique
--location espace_logique

Spécifie le tablespace par défaut de la base de données.

-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. Les ensembles de caractères supportés par le serveur PostgreSQL sont décrits dans Section 20.2.1.

-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