createdb
createdb — Créer une nouvelle base de données PostgreSQL™
Synopsis
createdb [
option
...] [
nombase
] [
description
]
Description
createdb crée une nouvelle base de
données.
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, sous réserve que l'utilisateur
qui lance la commande ait les droits appropriés.
createdb est un enrobage de la
commande SQL
CREATE
DATABASE. Il n'y a pas de réelle différence entre la création
de bases de données par cet outil ou à l'aide d'autres méthodes
d'accès au serveur.
Options
createdb accepte les arguments
suivants en ligne de commande :
-
nombase
-
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 le nom de l'utilisateur courant.
-
description
-
Le commentaire à associer à la base de données créée.
-
-D
tablespace
,
--location
tablespace
-
Le tablespace par défaut de la base de données.
-
-e,
--echo
-
Les commandes engendrées par createdb et envoyées au serveur sont
affichées.
-
-E
locale
,
--encoding
locale
-
L'encodage des caractères à utiliser dans la base de données.
Les jeux de caractères supportés par le serveur PostgreSQL™ sont décrits dans
Section 21.2.1,
« Jeux de caractères supportés ».
-
-O
propriétaire
,
--owner
propriétaire
-
Le propriétaire de la base de données.
-
-q,
--quiet
-
Aucune réponse n'est affichée.
-
-T
modèle
,
--template
modèle
-
La base de données modèle.
Les options -D, -E,
-O et -T
correspondent aux options de la commande SQL sous-jacente CREATE DATABASE, à consulter pour plus
d'informations sur ces options.
createdb accepte aussi les
arguments suivants en ligne de commande, pour les paramètres de
connexion :
-
-h
hôte
,
--host
hôte
-
Le nom de l'hôte sur lequel le serveur est en cours
d'exécution. Si la valeur commence avec un slash (NDT : barre
oblique, /), elle est utilisée comme répertoire du socket de
domaine Unix.
-
-p
port
,
--port
port
-
Le port TCP ou l'extension du fichier socket de domaine Unix
local sur lequel le serveur attend les connexions.
-
-U
nomutilisateur
,
--username
nomutilisateur
-
Le nom de l'utilisateur utilisé pour la connexion.
-
-W,
--password
-
Le mot de passe est obligatoirement demandé.
Environnement
-
PGDATABASE
-
S'il est configuré, précise le nom de la base de données à
créer. Peut-être 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 si ce dernier n'est pas spécifié sur la ligne
de commande ou par PGDATABASE.
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é, on peut se référer à CREATE
DATABASE et
psql(1) qui
présentent les problèmes éventuels et les messages d'erreurs. Le
serveur de bases de données doit être en cours d'exécution sur
l'hôte cible. De plus, tous les paramètres de connexion et
variables d'environnement par défaut utilisés par la bibliothèque
d'interface libpq s'appliquent.
Exemples
Créer la base de données demo sur 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 avec la commande
SQL
CREATE DATABASE
.
Créer la base de données demo sur le
serveur hébergé sur l'hôte eden, port
5000, en utilisant l'encodage LATIN1 avec
affichage de la commande engendrée :
$ createdb -p 5000 -h eden -E LATIN1 -e demo
CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'
CREATE DATABASE
clusterdb
