Au-delà de Linux® From Scratch (édition systemd) - Version 2017-08-22

Chapitre 22. Bases de données

PostgreSQL-9.6.4

Introduction à PostgreSQL

PostgreSQL est un système avancé de gestion de base de données relationnelles (ORDBMS), dérivé du système de gestion de base de données Berkeley Postgres.

Ce paquet est connu pour se construire correctement sur une plateforme LFS-8.0.

Informations sur le paquet

Dépendances de PostgreSQL

Facultatives

Python-2.7.13, Tcl-8.6.7, OpenSSL-1.1.0f, libxml2-2.9.4, libxslt-1.1.29, OpenLDAP-2.4.45, Linux-PAM-1.3.0, MIT Kerberos V5-1.15.1 et Bonjour

Facultative (Afin de régénérer la documentation)

docbook-4.5, docbook-dsssl-1.79, OpenJade-1.3.2 et SGMLSpm-1.1

Notes utilisateur : http://wiki.linuxfromscratch.org/blfs/wiki/postgresql

Installation de PostgreSQL

Installez PostgreSQL avec les commandes suivantes : 

sed -i '/DEFAULT_PGSOCKET_DIR/s@/tmp@/run/postgresql@' src/include/pg_config_manual.h &&

./configure --prefix=/usr          \
            --enable-thread-safety \
            --docdir=/usr/share/doc/postgresql-9.6.4 &&
make

Il y a de nombreux programmes dans le répertoire contrib/. Si vous allez lancer cette installation en tant que serveur et souhaitez construire certain d'entre eux, entrez make -C contrib ou make -C contrib/<SUBDIR-NAME> pour chaque sous-répertoire.

Les tests doivent être lancés en utilisateur normal, car ils ont besoin de démarrer un serveur temporaire, ce qui est empêché en tant qu’utilisateur root. Pour la même raison, vous devez arrêter tous les serveurs PostgreSQL lancés. Si une version précédente de PostgreSQL est installée, il peut être nécessaire d’utiliser --disable-rpath avec configure pour éviter des échecs, mais il n’est pas recommandé d’installer les binaires créés en utilisant cette option. Pour tester les résultats, tapez make check.

Maintenant, en tant qu'utilisateur root : 

make install      &&
make install-docs

Si vous avez fait tous les programmes de contrib/, en tant qu'utilisateur root: 

make -C contrib/<SUBDIR-NAME> install

Si vous pensez utiliser PostgreSQL en tant que client pour se connecter a un serveur sur une autre machine, votre installation est terminée et vous n'avez pas à lancer les commandes suivantes.

Initialisez un morceau (cluster) de base de données avec les commandes suivantes effectuées par l'utilisateur root : 

install -v -dm700 /srv/pgsql/data &&
install -v -dm755 /run/postgresql &&

groupadd -g 41 postgres &&
useradd -c "PostgreSQL Server" -g postgres -d /srv/pgsql/data \
        -u 41 postgres &&

chown -Rv postgres:postgres /srv/pgsql /run/postgresql

Maintenant, initialisez la base de données en tant qu'utilisateur root : 

su - postgres -c '/usr/bin/initdb -D /srv/pgsql/data'

De nouveau en tant qu'utilisateur root, démarrez le serveur de base de données avec la commande suivante : 

su - postgres -c '/usr/bin/postgres -D /srv/pgsql/data > \
                  /srv/pgsql/data/logfile 2>&1 &'

Toujours en tant qu'utilisateur root, créez une base de données et vérifiez l'installation : 

su - postgres -c '/usr/bin/createdb test' &&
echo "create table t1 ( name varchar(20), state_province varchar(20) );" \
    | (su - postgres -c '/usr/bin/psql test ') &&
echo "insert into t1 values ('Billy', 'NewYork');" \
    | (su - postgres -c '/usr/bin/psql test ') &&
echo "insert into t1 values ('Evanidus', 'Quebec');" \
    | (su - postgres -c '/usr/bin/psql test ') &&
echo "insert into t1 values ('Jesse', 'Ontario');" \
    | (su - postgres -c '/usr/bin/psql test ') &&
echo "select * from t1;" | (su - postgres -c '/usr/bin/psql test')

Pour éteindre le serveur, en tant qu'utilisateur root : 

su - postgres -c "/usr/bin/pg_ctl stop -D /srv/pgsql/data"

Explication des commandes

sed -i ...: Ce sed modifie: l'endroit du socket de /tmp vers /run/postgresql

--docdir=/usr/share/doc/postgresql-9.6.4 : Ce paramètre place la documentation dans un répertoire versionné.

--enable-thread-safety : Ce paramètre rend les bibliothèques clientes thread-safe en autorisant les threads parallèles dans libpq et aux programmes ECPG de contrôler en sécurité leur gestions de connexion privée.

--with-openssl : construit avec le support de OpenSSL pour les connexions chiffrées.

--with-perl : Construit le langage coté serveur PL/Perl.

--with-python : Construit le langage coté serveur PL/Python.

--with-tcl : construit le langage coté serveur PL/Tcl.

groupadd ... ; useradd ... : Ces commandes ajoutent un utilisateur et un groupe non privilégiés pour lancer le serveur de base de données.

createdb test; create table t1; insert into t1 values...; select * from t1 : Crée une base de données, y ajoute une table, insère des lignes dans la table et les sélectionne pour vérifier que l'installation fonctionne correctement.

Configuration de PostgreSQL

Fichiers de configuration

$PGDATA/pg_ident.con, $PGDATA/pg_hba.conf et $PGDATA/postgresql.conf

La variable d'environnement PGDATA est utilisée pour distinguer les clusters de base de données entre eux en la réglant sur la valeur du répertoire qui contient le cluster désiré. Les trois fichiers de configuration existent dans tout répertoire PGDATA/. Vous pouvez trouver des détails sur le format des fichiers et les options qu'on peut régler dans chacun d'eux sur file:///usr/share/doc/postgresql-9.6.4/html/index.html.

Unité Systemd

Installez l'unité postgresql.service incluse dans de paquet blfs-systemd-units-20160602. 

make install-postgresql

Contenu

Programmes installés: clusterdb, createdb, createlang, createuser, dropdb, droplang, dropuser, ecpg, initdb, pg_archivecleanup, pg_basebackup, pg_config, pg_controldata, pg_ctl, pg_dump, pg_dumpall, pg_isready, pg_receivexlog, pg_recvlogical, pg_resetxlog, pg_restore, pg_rewind, pg_test_fsync, pg_test_timing, pg_upgrade, pg_xlogdump, pgbench, pltcl_delmod, pltcl_listmod, pltcl_loadmod, postgres, postmaster (obsolete), psql, reindexdb, vacuumdb, et facultativement (dans contrib/) oid2name, pg_standby, vacuumlo, et beaucoup d'autres
Bibliothèques installées: libecpg.{so,a}, libecpg_compat.{so,a}, libpgcommon.a, libpgport.a, libpgtypes.{so,a}, libpq.{so,a}, des modules variés de caractères, et facultativement des modules de programmation sous /usr/lib/postgresql
Répertoires installés: /usr/include/{libpq,postgresql}, /usr/lib/postgresql, /usr/share/{doc/postgresql-9.6.4,postgresql} et /srv/pgsql

Descriptions courtes

clusterdb

est un outil pour reconstruire des tables dans une base de données PostgreSQL.

createdb

crée une nouvelle base de données PostgreSQL.

createlang

définit un nouveau langage procédural PostgreSQL.

createuser

définit un nouveau compte utilisateur PostgreSQL.

dropdb

supprime une base de données PostgreSQL.

droplang

supprime un langage procédural PostgreSQL.

dropuser

supprime un compte utilisateur PostgreSQL.

ecpg

est le préprocesseur SQL embarqué.

initdb

crée un nouveau cluster de base de données.

oid2name

résous les OIDs (Object IDs) et les nœuds de fichier dans le répertoire des données de PostgreSQL.

pg_archivecleanup

nettoie les fichiers d'archives de PostgreSQL WAL (write-ahead log).

pg_basebackup

fait des sauvegardes de la base sur une grappe PostgreSQL.

pg_config

récupère des informations sur la version de PostgreSQL.

pg_controldata

retourne des informations initialisées pendant initdb, telles que la version du catalogue et la locale du serveur.

pg_ctl

contrôle l'arrêt et le démarrage du serveur de base de données.

pg_dump

place dans un script des données et des méta-données de base de données, elles sont utilisées pour recréer la base de données.

pg_dumpall

appelle de manière récursive pg_dump pour chaque base de données d'un cluster.

pg_isready

vérifie le statut de la connexion du serveur PostgreSQL.

pg_receivexlog

est utilisé pour écouter un log de transaction depuis un cluster PostgreSQL.

pg_recvlogical

contrôle les flux de décodage logique de PostgreSQL.

pg_resetxlog

nettoie le journal écrit et réinitialise éventuellement des champs dans le fichier pg_control.

pg_restore

crée des bases de données à partir de fichiers cachés créés par pg_dump.

pg_rewind

synchronise un répertoire de données PostgreSQL avec un autre répertoire qui a été copié depuis le premier.

pg_standby

supporte la création d'un serveur PostgreSQL de secours à chaud.

pg_test_fsync

détermine la méthode wal_sync la plus rapide pour PostgreSQL.

pg_test_timing

mesure le temps de synchronisation.

pg_upgrade

met à jour une instance de serveur PostgreSQL.

pg_xlogdump

affiche une sortie lisible par un humain du log d'écriture d'un cluster de base de données PostgreSQL.

pgbench

lane un test de performance sur PostgreSQL.

pltcl_delmod

est un script de support utilisé pour effacer un module d'une table PL/Tcl. La commande exige que le paquet Pgtcl soit aussi installé.

pltcl_listmod

est un script support utilisé pour lister les modules d'une table PL/Tcl. La commande exige que le paquet Pgtcl soit aussi installé.

pltcl_loadmod

est un script support utilisé pour charger un module d'une table PL/Tcl. La commande exige que le paquet Pgtcl soit aussi installé.

postgres

est le serveur de bases de données PostgreSQL.

postmaster

(déprécié, un lien symbolique vers postgres) est un démon de base de données multi-utilisateurs.

psql

est un shell de base de données en console.

reindexdb

est un outil pour reconstruire les index d'une base de données.

vacuumdb

compacte des bases de données et génère des statistiques pour l'analyseur de demandes.

vacuumlo

efface les gros objets orphelins d'une base de données PostgreSQL.

libecpg.{so,a}

contiens des fonctions pour supporter du SQL embarqué dans des programmes C.

libecpg_compat.{so,a}

est la bibliothèque de compatibilité ecpg.

libgport.a

est le sous-système de port spécifique au backend Postgres.

libpgtypes.{so,a}

contiens des fonctions pour traiter des types de données Postgres.

libpq.{so,a}

est l'API de programmation C pour Postgres.

Last updated on 2017-08-16 22:38:22 +0200