initdb [option...] [--pgdata ] | [-D ]répertoire
initdb crée une nouvelle grappe de bases de données, ou « cluster », PostgreSQL™. Un cluster est un ensemble de bases de données gérées par une même instance du serveur.
Créer un cluster consiste à :
créer les répertoires dans lesquels sont stockées les données de la base ;
créer les tables partagées du catalogue (tables partagées par tout le cluster) ;
créer les bases de données template1 et postgres.
Lors de la création ultérieure d'une base de données, tout ce qui se trouve dans la base template1 est copié. (Ce qui implique que tout ce qui est installé dans template1 est automatiquement copié dans chaque base de données créée par la suite.) La base de données postgres est une base de données par défaut à destination des utilisateurs, des outils et des applications tiers.
initdb tente de créer le répertoire de données indiqué. Il se peut que la commande n'est pas les droits nécessaires si le répertoire parent du répertoire de données indiqué est possédé par root. Dans ce cas, pour réussir l'initialisation, il faut créer un répertoire de données vide en tant que root, puis utiliser chown pour en donner la possession au compte utilisateur de la base de données. su peut alors être utilisé pour prendre l'identité de l'utilisateur de la base de données et exécuter initdb.
initdb doit être exécuté par l'utilisateur propriétaire du processus serveur parce que le serveur doit avoir accès aux fichiers et répertoires créés par initdb. Comme le serveur ne peut pas être exécuté en tant que root, il est impératif de ne pas lancer initdb en tant que root. (En fait, initdb refuse de se lancer dans ces conditions.)
initdb initialise la locale et l'encodage par défaut du cluster. L'ordre de tri (LC_COLLATE) et les classes de jeux de caractères (LC_CTYPE, c'est-à-dire majuscule (upper), minuscule (lower), chiffre (digit)) sont fixées pour l'ensemble des bases de données et ne peuvent pas être modifiées. Les ordres de tri autres que C ou POSIX sont également moins performants. Pour ces raisons, il est important de choisir la bonne locale lors de l'exécution d'initdb. Les catégories de locale restantes peuvent être modifiées par la suite, serveur démarré. Toutes les valeurs de locales du serveur (lc_*) peuvent être affichées à l'aide de l'instruction SHOW ALL. Plus de détails sont disponibles dans Section 22.1, « Support des locales ».
L'encodage d'une base de données peut être configuré à sa création. initdb détermine l'encodage de la base de données template1, qui sert de modèle par défaut pour les autres bases de données. Cet encodage par défaut peut être modifié avec l'option --encoding. De plus amples détails sont présentés dans Section 22.2, « Support des jeux de caractères ».
Précise la méthode d'authentification utilisée dans pg_hba.conf pour les utilisateurs locaux. trust ne doit être utilisé que lorsque tous les utilisateurs locaux du système sont dignes de confiance. Pour faciliter l'installation, trust est la valeur par défaut.
Indique le répertoire de stockage de la grappe de bases de données. C'est la seule information requise par initdb. Il est possible d'éviter de préciser cette option en configurant la variable d'environnement PGDATA. Cela permet, de plus, au serveur de bases de données (postgres) de trouver le répertoire par cette même variable.
Définit l'encodage de la base de données modèle (template). C'est également l'encodage par défaut des bases de données créées ultérieurement. Cette valeur peut toutefois être surchargée. La valeur par défaut est déduite de la locale. Dans le cas où cela n'est pas possible, SQL_ASCII est utilisé. Les jeux de caractères supportés par le serveur PostgreSQL™ sont décrits dans Section 22.2.1, « Jeux de caractères supportés ».
Configure la locale par défaut pour le cluster. Si cette option n'est pas précisée, la locale est héritée de l'environnement d'exécution d'initdb. Le support des locales est décrit dans Section 22.1, « Support des locales ».
Même principe que --locale, mais seule la locale de la catégorie considérée est configurée.
Équivalent à --locale=C.
Définit le répertoire de stockage des journaux de transaction.
Précise le nom de l'utilisateur défini comme superutilisateur de la base de données. Par défaut, c'est le nom de l'utilisateur qui lance initdb. Le nom du superutilisateur importe peu, mais postgres peut être conservé, même si le nom de l'utilisateur système diffère.
Force initdb à demander un mot de passe pour le superutilisateur de la base de données. Cela n'a pas d'importance lorsqu'aucune authentification par mot de passe n'est envisagée. Dans le cas contraire, l'authentification par mot de passe n'est pas utilisable tant qu'un mot de passe pour le superutilisateur n'est pas défini.
Incite initdb à lire le mot de passe du superutilisateur à partir d'un fichier. La première ligne du fichier est utilisée comme mot de passe.
Sélectionne la configuration par défaut de la recherche plein texte. Voir default_text_search_config pour plus d'informations.
D'autres paramètres, moins utilisés, sont disponibles :
Affiche les informations de débogage du processus amorce et quelques autres messages de moindre intérêt pour le grand public. Le processus amorce est le programme qu'initdb lance pour créer les tables catalogues. Cette option engendre une quantité considérable de messages ennuyeux.
Indique à initdb où trouver les fichiers d'entrée nécessaires à l'initialisation du cluster. En temps normal, cela n'est pas nécessaire. Un message est affiché lorsque leur emplacement doit être indiqué de manière explicite.
Par défaut, lorsqu'initdb rencontre une erreur qui l'empêche de finaliser la création du cluster, le programme supprime tous les fichiers créés avant l'erreur. Cette option désactive le nettoyage. Elle est utile pour le débogage.
Indique le répertoire de stockage de la grappe de bases de données ; peut être surchargé avec l'option -D.
Cet outil, comme la plupart des autres outils PostgreSQL™, utilise aussi les variables d'environnement supportées par la bibliothèque libpq (voir Section 30.12, « Variables d'environnement »).
Applications relatives
au serveur PostgreSQL