Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
postgresql [Le 22/01/2021, 14:05] – [Formations] bcag2postgresql [Le 04/05/2026, 13:43] (Version actuelle) – [Guide de survie pour le client psql] liste les dates de création des bases de données bcag2
Ligne 1: Ligne 1:
- +{{tag>sgbd serveur réseau programmation}}
-{{tag>sgbd serveur réseau BROUILLON}}+
  
 ---- ----
Ligne 7: Ligne 6:
  
 ===== Introduction ===== ===== Introduction =====
-PostgreSQL est un système de gestion de bases de données ([[:SGBD]]) très performant sous licence BSD dont les performances sont comparables à Oracle 9.+[[wpfr>PostgreSQL]] est un système de gestion de bases de données ([[:SGBD]]) très performant sous licence BSD dont les performances sont comparables à Oracle 9.
  
  
-Il propose de très nombreuses fonctionnalités, tout en respectant les standards SQL : SQL 92, 99 et en partie la norme SQL2003. En outre, il intègre plusieurs langages embarqués (Perl, Python, Java) depuis de nombreuses années. [[http://www.postgresql.org/about/|Pour en savoir plus]]+Il propose de très nombreuses fonctionnalités, tout en respectant les standards SQL : SQL 92, 99 et en partie la norme SQL2003. En outre, il intègre plusieurs langages embarqués (Perl, Python, Java) depuis de nombreuses années. [[https://www.postgresql.org/about/|Pour en savoir plus]]
  
 ===== Documentation ===== ===== Documentation =====
  
  
-La documentation ainsi que d'autres informations sont disponibles sur le [[http://www.postgresql.org/|site officiel de PostgreSQL]].+La documentation ainsi que d'autres informations sont disponibles sur le [[https://www.postgresql.org/|site officiel de PostgreSQL]].
 La communauté [[https://www.postgresql.fr/|postgresql francophone]] la reprend en [[http://docs.postgresql.fr/|français]]. La communauté [[https://www.postgresql.fr/|postgresql francophone]] la reprend en [[http://docs.postgresql.fr/|français]].
  
Ligne 60: Ligne 59:
 Confirmation de l'existence d'un dossier **Datas/** déjà existant.\\ Confirmation de l'existence d'un dossier **Datas/** déjà existant.\\
 Lancer l'installation. Lancer l'installation.
-==== L'utilisateur postgres ====+ 
 +==== Désinstallation ==== 
 +Si vous souhaitez désinstaller, par exemple lors du passage à l'utilisation de conteneurs [[:docker]], il faut : 
 +<code bash> 
 +# arrêtez le service s'il est lancé 
 +sudo systemctl stop postgresql 
 +# lister les paquets installés liés à postgres : 
 +dpkg -l | grep postgres 
 +# et les supprimer : 
 +sudo apt --purge remove postgresql-* 
 +</code> 
 + 
 +===== Configuration ===== 
 +==== L'utilisateur postgres et psql ====
  
 PostgreSQL est un serveur qui permet de se connecter à différentes bases de données. Par défaut, seul l'utilisateur //postgres// peut se connecter. PostgreSQL est un serveur qui permet de se connecter à différentes bases de données. Par défaut, seul l'utilisateur //postgres// peut se connecter.
Ligne 82: Ligne 94:
 Vous devriez obtenir quelque chose comme : Vous devriez obtenir quelque chose comme :
 <code> <code>
-psql (9.5.10)+psql (13.1-1)
 Type "help" for help. Type "help" for help.
  
Ligne 100: Ligne 112:
 Cette ligne de commande sera bien sûr utilisée pour exécuter des requêtes SQL, et aussi des commandes internes à postgreSQL (elles commencent toutes par un antislash) Cette ligne de commande sera bien sûr utilisée pour exécuter des requêtes SQL, et aussi des commandes internes à postgreSQL (elles commencent toutes par un antislash)
  
-Petit guide de survie pour le client psql+==== Guide de survie pour le client psql ==== 
 +^ \h | pour l'aide-mémoire des commandes SQL| 
 +^ \? | pour l'aide-mémoire des commandes psql| 
 +^ \g | ou point-virgule en fin d'instruction pour exécuter la requête| 
 +^ \q | pour quitter| 
 +^ \l | liste les bases de données existantes| 
 +^ \du | liste les rôles (utilisateur ou groupe)| 
 +^ \c nom_base nom_utilisateur | connecte à la base <nom_base> avec le rôle <nom_utilisateur>| 
 +^ \lt | liste les tables de la base courante| 
 +^ set search_path to mon_schema1, mon_schema2; | intéressant à faire avant la commande ci-dessous !-)| 
 +^ \d | liste les tables du ou des schéma·s courant·s| 
 +^ \d nom_table_ou_vue | description de la table <nom_table> (colonne, type…) ou de la vue nom_vue| 
 +^ \d+ nom_table_ou_vue | description complète (avec commentaires!) de la table <nom_table> (colonne, type…) ou de la vue nom_vue avec son code source| 
 +^ \sv nom_vue | à la différence de \d+, n'affiche que le code source de la vue| 
 +^ \dn | liste tout le schéma de la base courante| 
 +^ \h ALTER TABLE | affiche l'aide pour la commande ALTER TABLE| 
 + 
 +Pour lister les schémas : 
 +<code sql> 
 +select *from pg_namespace; 
 +</code> 
 + 
 +Pour lister les tables d'un schéma : 
 +<code sql> 
 +select t.table_name 
 +from information_schema.tables t 
 +where t.table_schema = 'nom_schema'  -- remplacer le nom du schema ici 
 +and t.table_type = 'BASE TABLE' 
 +order by t.table_name; 
 +</code> 
 + 
 +Lister les vues : 
 +<code sql> 
 +select schemaname, viewname from pg_catalog.pg_views where schemaname NOT IN ('pg_catalog', 'information_schema') order by schemaname, viewname; 
 +</code> 
 + 
 +Lister les fonctions d'un schéma (**monSchema** dans l'exemple ci-dessous, à adapter) ((src: https://stackoverflow.com/a/1347639/6614155)) : 
 +<code sql> 
 +SELECT routines.routine_name, parameters.data_type, parameters.ordinal_position 
 +FROM information_schema.routines 
 +    LEFT JOIN information_schema.parameters ON routines.specific_name=parameters.specific_name 
 +WHERE routines.specific_schema='monSchema' 
 +ORDER BY routines.routine_name, parameters.ordinal_position; 
 +</code> 
 + 
 +Lister les droits (//\du// est très limité !) :
 <code> <code>
-        \h pour l'aide-mémoire des commandes SQL +select grantee, table_catalog, table_schema, table_name, string_agg(privilege_type, ', ' order by privilege_type) as privileges from information_schema.role_table_grants where grantee != 'postgres' group by grantee, table_catalog, table_schema, table_name;
-        \? pour l'aide-mémoire des commandes psql +
-        \g ou point-virgule en fin d'instruction pour exécuter la requête +
-        \q pour quitter+
 </code> </code>
 +
 +et si besoin :
 +<code sql>
 +REVOKE ALL ON SCHEMA mon_schema FROM mon_role;
 +</code>
 +
 +Lister les clés étrangères de la table //matable// dans //monschema// :
 +<code sql>
 +SELECT
 +    tc.table_schema, 
 +    tc.constraint_name, 
 +    tc.table_name, 
 +    kcu.column_name, 
 +    ccu.table_schema AS foreign_table_schema,
 +    ccu.table_name AS foreign_table_name,
 +    ccu.column_name AS foreign_column_name 
 +FROM information_schema.table_constraints AS tc 
 +JOIN information_schema.key_column_usage AS kcu
 +    ON tc.constraint_name = kcu.constraint_name
 +    AND tc.table_schema = kcu.table_schema
 +JOIN information_schema.constraint_column_usage AS ccu
 +    ON ccu.constraint_name = tc.constraint_name
 +WHERE tc.constraint_type = 'FOREIGN KEY'
 +    AND tc.table_schema='monschema'
 +    AND tc.table_name='matable';
 +</code>
 +
 +Lister les dates de création des bases de données :
 +<code sql>
 +SELECT (pg_stat_file('base/'||oid ||'/PG_VERSION')).modification, datname FROM pg_database;
 +-- Source - https://stackoverflow.com/a/30308875
 +</code>
 +
 ====Supprimer l'utilisateur Postgres du greeter sous xubuntu 14.04.1==== ====Supprimer l'utilisateur Postgres du greeter sous xubuntu 14.04.1====
 La suppression de l'utilisateur postgres dans le cas d'un greeter lightdm-webkit-greeter.\\ La suppression de l'utilisateur postgres dans le cas d'un greeter lightdm-webkit-greeter.\\
 Aller dans le répertoire **/var/lib/AccountsService/users/** .\\ Aller dans le répertoire **/var/lib/AccountsService/users/** .\\
-Créer un fichier text puis nommé-le **postgres** (nom de l'utilisateur postgres).\\+Créer un fichier text puis nommez-le **postgres** (nom de l'utilisateur postgres).\\
 Puis y ajouter le contenu suivant : Puis y ajouter le contenu suivant :
 <code> <code>
Ligne 151: Ligne 238:
 ... ...
 </code> </code>
-Puis redémarrez le serveur PostgreSQL: +Puis redémarrez le serveur PostgreSQL:
 <code> <code>
 $ sudo service postgresql restart $ sudo service postgresql restart
Ligne 167: Ligne 254:
 sudo pg_createcluster 9.3 main sudo pg_createcluster 9.3 main
 </code> </code>
-Puis redémarrez le serveur PostgreSQL: +Puis redémarrez le serveur PostgreSQL:
 <code> <code>
 $ sudo service postgresql restart $ sudo service postgresql restart
Ligne 173: Ligne 260:
 Vous pouvez maintenant reprendre le tutoriel au début de la section "L'utilisateur postgres". Vous pouvez maintenant reprendre le tutoriel au début de la section "L'utilisateur postgres".
 ==== encodage UTF-8  ==== ==== encodage UTF-8  ====
-<note tips> Ce paragraphe est optionnel </note> +Postgresql se base sur la configuration du système d'exploitation… qui est en UTF-8 par défaut sous les versions francophone d'Ubuntu.
-FIXME En version PostgreSQL 9.1.5, l'installateur semble avoir directement créé avec le bon codage. Cette opération semble donc être devenue inutile. +
- +
-L'installateur initialise le cluster postgresql avec le support de jeux de caractères SQL_ASCII +
- +
-Pour ceux qui souhaitent privilégier l'encodage **UTF-8** / locale **FR-fr**, il faut supprimer le cluster et le recréer. +
- +
-=== jeux de caractères par défaut === +
-  * Connexion en tant qu'utilisateur postgres  +
- +
-  sudo -i -u postgres +
- +
-  psql -l +
-                             List of databases +
-    Name    |  Owner   | Encoding  | Collate | Ctype |   Access privileges    +
-  ----------+----------+-----------+---------+-------+----------------------- +
-  postgres  | postgres | SQL_ASCII | C       | C     |  +
-  template0 | postgres | SQL_ASCII | C       | C     | =c/postgres          + +
-            |          |           |         |       | postgres=CTc/postgres +
-  template1 | postgres | SQL_ASCII | C       | C     | =c/postgres          + +
-            |          |           |         |       | postgres=CTc/postgres +
- +
-=== supprimer le cluster et le recréer === +
- +
-  * Identifier la version et le nom de votre cluster +
-  +
-  pg_lsclusters  +
-  Version Cluster   Port Status Owner    Data directory                     Log file +
-  9.1     main      5432 online postgres /var/lib/postgresql/9.1/main       /var/log/postgresql/postgresql-9.1-main.log +
- +
-  * Supprimer le cluster +
- +
-  pg_dropcluster 9.1 main --stop +
- +
-  * Créer le cluster +
- +
-  pg_createcluster --locale fr_FR.UTF-8 9.1 main +
- +
-  * Démarrage +
-  pg_ctlcluster 9.1 main start +
- +
-Les bases systèmes seront alors conformes aux locales système +
-   +
-  psql -l +
-                                  List of databases +
-    Name    |  Owner   | Encoding |   Collate   |    Ctype    |   Access privileges    +
-  ----------+----------+----------+-------------+-------------+----------------------- +
-  postgres  | postgres | UTF8     | fr_FR.UTF-8 | fr_FR.UTF-8 |  +
-  template0 | postgres | UTF8     | fr_FR.UTF-8 | fr_FR.UTF-8 | =c/postgres          + +
-            |          |          |             |             | postgres=CTc/postgres +
-  template1 | postgres | UTF8     | fr_FR.UTF-8 | fr_FR.UTF-8 | =c/postgres          + +
-            |          |          |             |             | postgres=CTc/postgres +
- +
  
 ==== Créer un utilisateur PostgreSQL ==== ==== Créer un utilisateur PostgreSQL ====
Ligne 236: Ligne 270:
 Par facilité, nous allons assimiler les utilisateurs du système à ceux qui se connecteront avec psql, mais ce n'est nullement obligatoire. Par la suite, nous supposerons que votre login système est ''nom_utilisateur''. Par facilité, nous allons assimiler les utilisateurs du système à ceux qui se connecteront avec psql, mais ce n'est nullement obligatoire. Par la suite, nous supposerons que votre login système est ''nom_utilisateur''.
  
-Commencez par créer un nouvel utilisateur, qui portera par exemple le même nom que vous. Dans la ligne de commande ci-dessous, tapez (rappel : la partie « postgres=# » est l'invite de commande, il ne faut pas la retaper ! Ainsi, la commande ci-dessous requiert de taper « CREATE USER <nom_utilisateur>; », en remplaçant <nom_utilisateur> par un identifiant bien choisi) :+Commencez par créer un nouvel utilisateur, qui portera par exemple le même nom que vous. Dans la ligne de commande ci-dessous, tapez (rappel : la partie « postgres=# » est l'invite de commande, il ne faut pas la retaper ! Ainsi, la commande ci-dessous requiert de taper « CREATE ROLE <nom_utilisateur>; », en remplaçant <nom_utilisateur> par un identifiant bien choisi) :
 <code> <code>
-postgres=# CREATE USER <nom_utilisateur>;+postgres=# CREATE ROLE <nom_utilisateur> LOGIN;
 </code> </code>
 N'oubliez pas le point-virgule à la fin... N'oubliez pas le point-virgule à la fin...
Ligne 245: Ligne 279:
 Donnez-lui la possibilité de créer de nouvelles bases de données : Donnez-lui la possibilité de créer de nouvelles bases de données :
 <code> <code>
-postgres=# ALTER ROLE <nom_utilisateur> WITH CREATEDB;+postgres=# ALTER ROLE <nom_utilisateur> CREATEDB;
 </code> </code>
  
Ligne 260: Ligne 294:
 Attribuer un mot de passe à l'utilisateur pour qu'il puisse se connecter à la base (le ENCRYPTED permet l'utilisation de md5 dans le pg_hba.conf) : Attribuer un mot de passe à l'utilisateur pour qu'il puisse se connecter à la base (le ENCRYPTED permet l'utilisation de md5 dans le pg_hba.conf) :
 <code> <code>
-postgres=# ALTER USER <nom_utilisateur> WITH ENCRYPTED PASSWORD 'mon_mot_de_passe';+postgres=# ALTER ROLE <nom_utilisateur> WITH ENCRYPTED PASSWORD 'mon_mot_de_passe';
 </code> </code>
  
Ligne 269: Ligne 303:
 </code> </code>
  
-La ligne de commande est devenue : +La ligne de commande est devenue :
 <code> <code>
 nom_base_de_donnee=> nom_base_de_donnee=>
Ligne 276: Ligne 310:
 Notez la transformation du # en > : vous n'êtes plus superutilisateur... Notez la transformation du # en > : vous n'êtes plus superutilisateur...
  
 +<note tip>Il peut être plus simple pour commencer d'utiliser la commande **createuser --interactive <nom-utilisateur>** en ligne de commande (hors psql) qui est interactive et vous demande les autorisations à y associer (LOGIN, SUPERUSER, CREATEDB, CREATEROLE…)</note>
  
 ==== Pour aller plus loin ==== ==== Pour aller plus loin ====
Ligne 288: Ligne 323:
  
 Il faut d'abord modifier le fichier de configuration pour autoriser les connexions via mot de passe chiffré (sur les versions récentes, au moins la 12, ça ne semble pas nécessaires) : Il faut d'abord modifier le fichier de configuration pour autoriser les connexions via mot de passe chiffré (sur les versions récentes, au moins la 12, ça ne semble pas nécessaires) :
-<code>+<code bash>
 sudo nano /etc/postgresql/x.x/main/pg_hba.conf  sudo nano /etc/postgresql/x.x/main/pg_hba.conf 
 </code> </code>
Ligne 295: Ligne 330:
  
 Les utilisateurs "avancés" noteront que le fichier est amplement commenté. Les utilisateurs "avancés" noteront que le fichier est amplement commenté.
-Voir la [[http://www.postgresql.org/docs/8.2/static/index.html|documentation]] pour plus d'informations.+Voir la [[https://www.postgresql.org/docs/8.2/static/index.html|documentation]] pour plus d'informations.
  
 <note important>Si vous modifiez les paramètres de la sécurité, avant de relancer postgresql pensez à donner un mot de passe à l'utilisateur postgres (voir plus bas)</note> <note important>Si vous modifiez les paramètres de la sécurité, avant de relancer postgresql pensez à donner un mot de passe à l'utilisateur postgres (voir plus bas)</note>
-Modifier le fichier en remplaçant **ident sameuser** par **md5** afin d'obtenir les lignes suivantes : +Modifier le fichier en remplaçant **ident sameuser** par **md5** afin d'obtenir les lignes suivantes :
  
-<code>+<code bash>
 ... ...
 # Database administrative login by Unix domain socket # Database administrative login by Unix domain socket
Ligne 318: Ligne 353:
 La modification des paramètres de connexion au serveur nécessite son redémarrage pour que ces derniers soient pris en compte. La modification des paramètres de connexion au serveur nécessite son redémarrage pour que ces derniers soient pris en compte.
  
-<code>+<code bash>
 $ sudo service postgresql restart $ sudo service postgresql restart
 </code> </code>
 ou ou
-<code>+<code bash>
 $ sudo pg_ctlcluster 9.5 main restart $ sudo pg_ctlcluster 9.5 main restart
 </code> </code>
Ligne 328: Ligne 363:
 On peut ensuite créer notre utilisateur : On peut ensuite créer notre utilisateur :
  
-<code>+<code bash>
 $ sudo -i -u postgres $ sudo -i -u postgres
 $ createuser -P --interactive <nom_utilisateur> $ createuser -P --interactive <nom_utilisateur>
Ligne 339: Ligne 374:
  
 Puis, on lui crée une base de données dédiée : Puis, on lui crée une base de données dédiée :
-<code>+<code bash>
 $ createdb -O <nom_utilisateur> -E UTF8 <ma_database> $ createdb -O <nom_utilisateur> -E UTF8 <ma_database>
 </code> </code>
Ligne 348: Ligne 383:
 L'option //-O <nom_utilisateur>//  est là pour préciser l'identité du propriétaire de la base <ma_database>. L'option //-O <nom_utilisateur>//  est là pour préciser l'identité du propriétaire de la base <ma_database>.
 </note> </note>
- 
  
 Ensuite, on peut se connecter via : Ensuite, on peut se connecter via :
-<code>+<code bash>
 $ psql -U <nom_utilisateur> $ psql -U <nom_utilisateur>
-Mot de passe pour l'utilisateur <nom_utilisateur> : +Mot de passe pour l’utilisateur <nom_utilisateur> : 
 </code> </code>
  
-ou, si le nom de la base de l'utilisateur n'est pas le même que celui de l'utilisateur :  +ou, si le nom de la base de l'utilisateur n'est pas le même que celui de l'utilisateur : 
-<code>+<code bash>
 $ psql -U <nom_utilisateur> <nom_database_de_l_utilisateur> $ psql -U <nom_utilisateur> <nom_database_de_l_utilisateur>
-Mot de passe pour l'utilisateur <nom_utilisateur> : +Mot de passe pour l’utilisateur <nom_utilisateur> : 
 </code> </code>
  
Ligne 367: Ligne 401:
 == Les variables d'environnement == == Les variables d'environnement ==
 Les [[http://docs.postgresqlfr.org/9.0/libpq-envars.html|variables  d'environnement]] sont utilisées pour sélectionner des valeurs par défaut pour les paramètres de connexion. Les [[http://docs.postgresqlfr.org/9.0/libpq-envars.html|variables  d'environnement]] sont utilisées pour sélectionner des valeurs par défaut pour les paramètres de connexion.
-Les plus intéressantes à utiliser son PGUSER et PGHOST (notamment pour cette dernière si vous administrez une base qui n'est pas sur un serveur //localhost//).+Les plus intéressantes à utiliser son //PGUSER// et //PGHOST// (notamment pour cette dernière si vous administrez une base qui n'est pas sur un serveur //localhost//).
  
 Pour que ces variables soient systématiquement disponibles dans votre shell de commandes, il faut les ajouter dans le fichier ~/.profile correspondant à votre utilisateur. Pour que ces variables soient systématiquement disponibles dans votre shell de commandes, il faut les ajouter dans le fichier ~/.profile correspondant à votre utilisateur.
-Les lignes à ajouter sont (à vous de défionir les variables à ajouter):+Les lignes à ajouter sont (à vous de définir les variables à ajouter): 
 +<code bash>
   export PGHOST=<nom_hôte>   export PGHOST=<nom_hôte>
   export PGUSER=<nom_utilisateur>   export PGUSER=<nom_utilisateur>
    ...    ...
-    + </code> 
- La variable PGUSER étant ainsi définie, votre connexion peut alors se résumer à +  
 + La variable //PGUSER// étant ainsi définie, votre connexion peut alors se résumer à 
 +<code bash>
   psql <nom_database>   psql <nom_database>
 +</code>
 et si vous définissez PGDATABASE, votre connexion express sera simplement et si vous définissez PGDATABASE, votre connexion express sera simplement
 +<code bash>
   psql   psql
 +</code>
  
 <note> <note>
 il faut toujours saisir le mot de passe correspondant à l'utilisateur. Une variable PGPASSWORD existe, mais pour des raisons de sécurité, il est vivement recommandé de ne pas en faire usage. il faut toujours saisir le mot de passe correspondant à l'utilisateur. Une variable PGPASSWORD existe, mais pour des raisons de sécurité, il est vivement recommandé de ne pas en faire usage.
 </note> </note>
- 
  
 == Le fichier .pgpass == == Le fichier .pgpass ==
Ligne 390: Ligne 429:
 Ce fichier n'existe pas par défaut, il vous faut donc le créer. Ce fichier n'existe pas par défaut, il vous faut donc le créer.
   nano ~/.pgpass   nano ~/.pgpass
-Son contenu est simplement défini par les chaînes de connexions à utiliser. +Son contenu est simplement défini par les chaînes de connexions à utiliser.
   localhost:5432:*:nomutilisateur:motdepasse    localhost:5432:*:nomutilisateur:motdepasse 
 Ceci indiquera à votre client psql que l'utilisateur //nomutilisateur// accompagné du mot de passe //modepasse// est à utiliser pour la connexion à toutes //*// les bases de données de votre serveur //localhost// sur le port //5432// (port standard postgresql). Ceci indiquera à votre client psql que l'utilisateur //nomutilisateur// accompagné du mot de passe //modepasse// est à utiliser pour la connexion à toutes //*// les bases de données de votre serveur //localhost// sur le port //5432// (port standard postgresql).
Ligne 397: Ligne 436:
 Et la sécurité ? Et la sécurité ?
 si vous tentez une connexion si vous tentez une connexion
 +<code bash>
   psql <nom_database>   psql <nom_database>
 +
   WARNING: password file "/home/<user>/.pgpass" has group or world access; permissions should be u=rw (0600) or less   WARNING: password file "/home/<user>/.pgpass" has group or world access; permissions should be u=rw (0600) or less
 +</code>
 La limitation des droits d'accès à ce fichier est recommandée La limitation des droits d'accès à ce fichier est recommandée
 +<code bash>
   chmod 0600 ~/.pgpass.   chmod 0600 ~/.pgpass.
 +</code>
  
 === Personnalisation === === Personnalisation ===
-Le tuning d'un serveur postgreSQL se fait grâce au fichier **postgresql.conf** généralement positionné dans **/etc/postgresql/9.1/main/**+Le tuning d'un serveur postgreSQL se fait grâce au fichier **postgresql.conf** généralement positionné dans **/etc/postgresql/X.x/main/**, X.x étant la version utilisée de postgreSQL.
  
 Plusieurs paramètres sont faciles à modifier et peuvent apporter un gain de performance important: Plusieurs paramètres sont faciles à modifier et peuvent apporter un gain de performance important:
Ligne 415: Ligne 458:
  
 Ces quelques paramètres doivent suffire dans la majorité des cas. Si vous souhaitez aller plus loin dans le tuning de PostgreSQL, je vous conseille d'aller voir là [[http://docs.postgresqlfr.org|documentation PostgreSQL]] (qui existe en français) Ces quelques paramètres doivent suffire dans la majorité des cas. Si vous souhaitez aller plus loin dans le tuning de PostgreSQL, je vous conseille d'aller voir là [[http://docs.postgresqlfr.org|documentation PostgreSQL]] (qui existe en français)
- 
- 
  
 === Rôles et droits === === Rôles et droits ===
Ligne 423: Ligne 464:
 Les droits affectés à ces rôles permet une gestion fine des autorisations d'accès aux différents objets de la base de données (tables, vues, fonctions, champs...) Les droits affectés à ces rôles permet une gestion fine des autorisations d'accès aux différents objets de la base de données (tables, vues, fonctions, champs...)
  
-La  [[http://docs.postgresql.fr/9.1/user-manag.html|documentation postgresql]] est explicite à ce sujet, le mieux est de la consulter !+La  [[https://docs.postgresql.fr/9.1/user-manag.html|documentation postgresql]] est explicite à ce sujet, le mieux est de la consulter !
  
 === Gestion des connexions === === Gestion des connexions ===
Ligne 431: Ligne 472:
 La documentation complète est disponible à ces adresses La documentation complète est disponible à ces adresses
  
-//[[http://docs.postgresql.fr/9.1/runtime-config-connection.html|/etc/postgresql/x.x/main/postgresql.conf]]//+//[[https://docs.postgresql.fr/9.1/runtime-config-connection.html|/etc/postgresql/x.x/main/postgresql.conf]]//
  
-//[[http://docs.postgresql.fr/9.1/client-authentication.html|/etc/postgresql/x.x/main/pg_hba.conf]]//+//[[https://docs.postgresql.fr/9.1/client-authentication.html|/etc/postgresql/x.x/main/pg_hba.conf]]//
  
  
Ligne 439: Ligne 480:
 Différentes contributions sont disponibles (cf la [[http://docs.postgresqlfr.org/9.1/contrib.html|documentation PostgreSQL]]). Leur installation (et désinstallation) est facilitée par l'existence de paquets dédiés Différentes contributions sont disponibles (cf la [[http://docs.postgresqlfr.org/9.1/contrib.html|documentation PostgreSQL]]). Leur installation (et désinstallation) est facilitée par l'existence de paquets dédiés
  
-<code>+<code bash>
 sudo apt-get install postgresql-contrib sudo apt-get install postgresql-contrib
 Les paquets supplémentaires suivants seront installés :  Les paquets supplémentaires suivants seront installés : 
Ligne 447: Ligne 488:
 Les scripts permettant l'application de ces extensions sont disponibles dans **/usr/share/postgresql/9.1/extension/*.sql** Les scripts permettant l'application de ces extensions sont disponibles dans **/usr/share/postgresql/9.1/extension/*.sql**
 L'ajout se fait par exécution du script concerné sur la base de données souhaitée. L'ajout se fait par exécution du script concerné sur la base de données souhaitée.
-<code>+<code bash>
 $ psql -U <nom_utilisateur> <nom_database> -f /usr/share/postgresql/9.1/extension/<nom_extension>.sql $ psql -U <nom_utilisateur> <nom_database> -f /usr/share/postgresql/9.1/extension/<nom_extension>.sql
 </code> </code>
Ligne 454: Ligne 495:
  
 Pour ne permettre seulement une consultation des données par un utilisateur sans droit de modification, il faut exécuter la requête suivante: Pour ne permettre seulement une consultation des données par un utilisateur sans droit de modification, il faut exécuter la requête suivante:
-<code>+<code sql>
 ALTER USER <nom_utilisateur>  set default_transaction_read_only = on; ALTER USER <nom_utilisateur>  set default_transaction_read_only = on;
 </code> </code>
- 
- 
- 
- 
- 
- 
- 
- 
  
 ===== Installation de la cartouche spatiale PostGIS ===== ===== Installation de la cartouche spatiale PostGIS =====
-====Ce qu'est postgis==== +Reportez-vous à la page [[:postgis]]
-[[http://postgis.refractions.net/|Postgis]] est une extension de postgresql qui permet la gestion d'objets géographiques. Concrètement la cartouche spatiale postgis ajoute au serveur : +
-  *  la possibilité de définir le type de champ //geometry//  +
-  * l'ensemble des fonctions permettant les traitements géographiques +
-  * la base de référence des projections géographiques //spatial_ref_sys// +
-  * la base de gestion des attributs géographiques des tables //geometry_columns// +
-====Installation==== +
-Installer le paquet correspondant à votre version de postgres, exemples: +
-  * [[apt://postgresql-10-postgis-2.4|postgresql-10-postgis-2.4]] sous [[:bionic]] +
-  * [[apt://postgresql-9.1-postgis|postgresql-9.1-postgis]]+
  
-<code> +===== Clients graphiques =====
-Les paquets supplémentaires suivants seront installés :  +
-  libgeos-3.2.2 libgeos-c1 libproj0 postgis proj-data +
-</code>+
  
-Les scripts nécessaires à la capacitation géographique de postgresql sont installé dans le dossier\\ +==== DBeaver ==== 
- // /usr/share/postgresql/9.1/contrib/postgis-1.5/// ou\\ +Si vous utilisez d'autres types de base de données, cette solution a l'avantage de les supporter,\\ voir la page [[:dbeaver]]
- // /usr/share/postgresql/10/contrib/postgis-2.4/// +
- +
-====Donner à une base la capacité géographique==== +
- +
- +
-<note> +
-Les scripts donnés ci-après prennent pour hypothèse qu'un nouvel utilisateur a été créé avec la méthode [[postgresql#pour_aller_plus_loin|recommandée]] +
-</note> +
- +
-Tout d'abord, créer la base de données en question +
-  createdb -U <nom_utilisateur> <nom_base_geo> +
-Puis on utilser le rôle postgres (super user postgresql) +
-  $ sudo -i -u postgres  +
-pour exécuter dans cet ordre les scripts suivants : +
- +
-  psql -f /usr/share/postgresql/9.1/contrib/postgis-1.5/postgis.sql  <nom_base_geo> +
-  psql -f /usr/share/postgresql/9.1/contrib/postgis-1.5/spatial_ref_sys.sql  <nom_base_geo> +
- +
-puis on quitte le shell postgres +
-  exit +
-   +
-<note tip> +
-Si vous êtes amenés à créer plusieurs bases géographiques, il peut être intéressant de créer une base qui serve de modèle, par exemple //template_postgis// +
-Il est ensuite très facile de créer une base géographique en appelant ce modèle lors de la création d'un base +
-  createdb -U <nom_utilisateur> -T template_postgis <nom_base_geo> +
-</note> +
- +
-Pour faire des imports et des exports (car la fonction sur phppgadmin est bancale) : +
- +
-  $ sudo -i -u postgres +
- +
-export : +
-  pg_dump <nom_de_la_base> > nom_de_la_base.pgdump +
- +
-import: +
-  cat  nom_de_la_base.pgdump | psql -d  nom_de_la_base +
- +
-===== Clients graphiques =====+
  
  
Ligne 539: Ligne 522:
 PgAdmin III est un outil graphique d'administration de votre serveur PostgreSQL. L'application pgAdmin III peut être utilisé pour administrer les serveurs PostgreSQL 7.3 et les versions supérieures. PgAdmin III existe pour toutes les plateformes dont, évidemment, Ubuntu, KUbuntu, XUbuntu. PgAdmin III est un outil graphique d'administration de votre serveur PostgreSQL. L'application pgAdmin III peut être utilisé pour administrer les serveurs PostgreSQL 7.3 et les versions supérieures. PgAdmin III existe pour toutes les plateformes dont, évidemment, Ubuntu, KUbuntu, XUbuntu.
  
-PgAdmin III a été conçu pour répondre aux besoins de tous les utilisateurs, depuis la rédaction de simple requêtes SQL au développement complexe de base de données. L'interface graphique supporte toutes les fonctionnalités de PostGreSQL et permet une administration simple. L'application inclut aussi un éditeur de requête avec coloration syntaxique, un éditeur de code, un agent de gestion de tâche automatique, un support pour les réplication via Slony-I et bien d'autres fonctionnalités. +PgAdmin III a été conçu pour répondre aux besoins de tous les utilisateurs, depuis la rédaction de simple requêtes SQL au développement complexe de base de données. L'interface graphique supporte toutes les fonctionnalités de PostGreSQL et permet une administration simple. L'application inclut aussi un éditeur de requête avec coloration syntaxique, un éditeur de code, un agent de gestion de tâche automatique, un support pour les réplication via Slony-I et bien d'autres fonctionnalités.
  
 == Installation du client pgadmin3 == == Installation du client pgadmin3 ==
Ligne 548: Ligne 531:
 Cela va également installer les paquets suivants : Cela va également installer les paquets suivants :
   * libpq4   * libpq4
-  * libwxbase2.6-0 +  * libwxbase2.6-0
   * libwxgtk2.6-0   * libwxgtk2.6-0
   * pgadmin3-data   * pgadmin3-data
Ligne 558: Ligne 541:
 == Lancement du client pgadmin3 == == Lancement du client pgadmin3 ==
  
-Sous Ubuntu, pour lancer PgAdmin III, aller dans le menu **Applications** => **programmation** => **pgAdmin III** +Sous Ubuntu, pour lancer PgAdmin III, aller dans le menu **Applications** => **programmation** => **pgAdmin III**
 <note>**Remarque:** <note>**Remarque:**
  
Ligne 629: Ligne 612:
 ====Pool de connexion : PgBouncer==== ====Pool de connexion : PgBouncer====
 [[pgbouncer|PgBouncer]] [[pgbouncer|PgBouncer]]
-===== Récupération du contenu d'une base de données après un crash serveur =====+===== Sauvegarde et Restauration ===== 
 +Il est conseillé de lire le support de [[#formations|formation]] //PostgreSQL Administration (DBA1)// qui contient les chapitres //Politique de sauvegarde// et //Sauvegarde et restauration//\\ 
 +On pourra lire aussi [[https://cyber.gouv.fr/sites/default/files/document/anssi-fondamentaux-sauvegarde_systemes_dinformation_v1-0.pdf|SAUVEGARDE DES SYSTÈMES D’INFORMATION − LES FONDAMENTAUX]] de l’ANSII 
 + 
 +==== PgDump ==== 
 +Cette commande dispose de nombreuses options, cf. [[https://www.postgresql.org/docs/current/app-pgdump.html|la doc officielle sur pg_dump]] pour plus de détails.\\ 
 +Quelques exemples classiques : 
 +<code bash> 
 +# une sauvegarde simple va se faire par : 
 +pg_dump -f dump-de-ma-base.sql ma_base 
 +# si on ne veut que le schéma (le schéma par défaut est le schéma nommé public) : 
 +pg_dump ma_base --schema-only --schema mon_schema -f ~/dump-de-mon-schema.sql 
 +# et de façon similaire, que les données : 
 +pg_dump ma_base --data-only --schema mon_schema -f ~/dump-de-mes-data.sql 
 +# et pour ne sauver qu'une table : 
 +pg_dump ma_base --table ma_table --schema mon_schema -f ~/dump-de-ma-table.sql 
 +</code> 
 +==== pgBackRest ==== 
 +Le site officiel [[https://pgbackrest.org|pgBackRest]] et [[https://ng-pe.github.io/pgbackrest_doc_fr/user-guide.html|le guide utilisateur traduit]]  
 + 
 +=== Installation === 
 +Simplement  
 +<code bash> 
 +sudo apt install pgbackrest 
 +</code>
  
 +==== Récupération du contenu d'une base de données après un crash serveur ====
 Supposons que vous ayez installé sous [[ubuntu_server|ubuntu server]] une application d'entreprise s'appuyant sur une base de données postgresql (cette procédure a été testée avec [[redmine|redmine]]), et qu'un crash se produise qui rende impossible de redémarrer le serveur. Se pose alors le problème de la récupération des données. La procédure est relativement simple. Il va vous falloir: Supposons que vous ayez installé sous [[ubuntu_server|ubuntu server]] une application d'entreprise s'appuyant sur une base de données postgresql (cette procédure a été testée avec [[redmine|redmine]]), et qu'un crash se produise qui rende impossible de redémarrer le serveur. Se pose alors le problème de la récupération des données. La procédure est relativement simple. Il va vous falloir:
   * Monter votre ancienne installation depuis une autre installation ou via un live cd   * Monter votre ancienne installation depuis une autre installation ou via un live cd
Ligne 682: Ligne 690:
 </code> </code>
  
-<note tip>L'option ''--owner=NOM_APPLI'' de la troisième commande suppose que vous avez configuré un utilisateur système pour votre application</note>+<note tip>L'option ''​%%--%%owner=NOM_APPLI'' de la troisième commande suppose que vous avez configuré un utilisateur système pour votre application</note>
  
 ===== Formations ===== ===== Formations =====
Ligne 690: Ligne 698:
 exemple: lien directe au support PDF de la formation //DBA1 - PostgreSQL Administration// : [[https://dali.bo/dba1_pdf]] exemple: lien directe au support PDF de la formation //DBA1 - PostgreSQL Administration// : [[https://dali.bo/dba1_pdf]]
  
 +===== Voir aussi =====
 +  * [[https://www.pgmodeler.io|PgModeler]] qui permet de définir le modèle et générer les scripts de mise à jour de la base postgresql, installable depuis les dépôts <code bash>sudo apt install pgmodeler</code>
 +  * (en) [[https://labs.dalibo.com/temboard|temboard]] outils de supervision et configuration d'instances Postgresql
  
 ---- ----
  
-//Contributeurs : [[utilisateurs:yannick_LM|Yannick]], [[utilisateurs:sparky|Sparky]], [[utilisateurs:elemmire|Elemmire]], [[utilisateurs:aldian|Aldian]], [[utilisateurs:fred|Fred]],[[utilisateurs:xavierjm|XAVIER_jean-marie]]. //+//Contributeurs : [[utilisateurs:yannick_LM|Yannick]], [[utilisateurs:sparky|Sparky]], [[utilisateurs:elemmire|Elemmire]], [[utilisateurs:aldian|Aldian]], [[utilisateurs:fred|Fred]], [[utilisateurs:xavierjm|XAVIER_jean-marie]], [[utilisateurs:bcag2|bcag2]] //
postgresql.1611320734.txt.gz · Dernière modification : de bcag2
CC Attribution-Noncommercial-Share Alike 4.0 International Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Noncommercial-Share Alike 4.0 International