Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
postgresql [Le 13/01/2017, 17:16] 194.199.143.45 [Mise à jour Postgres EntrepriseDB avec conservation des Bases de Données] |
postgresql [Le 05/03/2024, 11:27] (Version actuelle) bcag2 [Guide de survie pour le client psql] lister les schémas |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | |||
{{tag>sgbd serveur réseau BROUILLON}} | {{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é [[http://www.postgresqlfr.org/|postgresqlfr.org]] 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]]. |
===== Installation du serveur PostgreSQL===== | ===== Installation du serveur PostgreSQL===== | ||
- | On commence par [[:tutoriel/comment_installer_un_paquet|installer]] le paquet [[apt://postgresql|postgresql]]. | + | ==== Méthode recommandée ==== |
- | + | ||
- | <code> | + | |
- | Les paquets supplémentaires suivants seront installés : | + | |
- | libpq5 postgresql-9.1 postgresql-client-9.1 postgresql-client-common | + | |
- | </code> | + | |
- | + | ||
- | La version installée par défaut (Precise Pangolin) est la 9.1. Il est possible d'installer une ancienne version majeure (ici la 8.4). Il faut alors le préciser à l'installation. [[apt://postgresql-8.4|postgresql-8.4]]. | + | |
+ | [[:tutoriel/comment_installer_un_paquet|Installez]] simplement le paquet [[apt://postgresql|postgresql]], soit en ligne de commande : | ||
+ | <code>sudo apt install postgresql</code> | ||
Notez que l'installation ajoute l'utilisateur postgres à la liste des utilisateurs. Utilisez finger si vous souhaitez de plus amples informations sur ce nouvel utilisateur (finger est un utilitaire permettant de consulter les informations relatives aux utilisateurs système, il n'est pas installé par défaut dans ubuntu) | Notez que l'installation ajoute l'utilisateur postgres à la liste des utilisateurs. Utilisez finger si vous souhaitez de plus amples informations sur ce nouvel utilisateur (finger est un utilitaire permettant de consulter les informations relatives aux utilisateurs système, il n'est pas installé par défaut dans ubuntu) | ||
<code>finger postgres</code> | <code>finger postgres</code> | ||
- | ==== Installation du serveur PostgreSQL-9.4 enterpriseDB sur Ubuntu 14.04 TLS ==== | + | ==== Installation manuelle avec l'installeur interactif EnterpriseDB ==== |
- | Téléchargez le fichier .run [[http://www.enterprisedb.com/products-services-training/pgdownload]]. | + | Téléchargez le dernier fichier .run sur [[http://www.enterprisedb.com/products-services-training/pgdownload|cette page]] (elle est référencée sur [[https://www.postgresql.org/download/linux/ubuntu/|le site officiel]]) - vous aurez probablement besoin de la version //Linux x86-64//. |
- | - Soit vous laissez le fichier dans le dossier téléchargement de votre /home ou bien vous le déplacer vers le répertoire /opt, comme moi (sudo mv .....). | + | - rendez le fichier executable : |
- | - Vous rendez le fichier executable : sudo chmod +x postgresql-9.4.0-1-linux-x64.run | + | <code>sudo chmod +x postgresql-10.6-1-linux-x64.run</code> |
- | - Puis vous executez avec la commande : sudo ./postgresql-9.4.0-1-linux-x64.run | + | - puis exécutez-le en tant que [[:sudo|super utilisateur]] avec la commande : |
+ | <code>sudo ./postgresql-10.6-1-linux-x64.run</code> | ||
- | Suivez les étapes désignées par l'interface graphique de l'installer postgreSQL | + | Suivez les étapes affichées par l'interface graphique de l'installeur. |
- | Une fois l'installation terminée, normalement vous avez postgreSQL installé et pgAdmin3 également installé | + | Une fois l'installation terminée, PostgreSQL devrait être installé ainsi que pgAdmin. |
- | Cependant, l'icon de pgAdmin3 n'est pas visible dans le menu (enfin c'était mon cas). | + | Cependant, l'icône de pgAdmin n'est pas visible dans le menu (enfin c'était mon cas). |
- | Dans ce cas, allez dans le dossier** /usr/share/applications/** et recherchez l' icone de pgadminIII. | + | Dans ce cas, allez dans le dossier** /usr/share/applications/** et recherchez l'icône de pgadmin. |
- | Changer les droit en écriture (sudo chmod o+w pgadminIII), puis l'ouvrir avec un éditeur de texte de type MousePad. | + | Changer les droit en écriture (sudo chmod o+w pgadminIII), puis l'ouvrir avec un éditeur de texte. |
Dans mon cas, j'ai dû y ajouter la ligne :**Categories=Development;Engineering;** | Dans mon cas, j'ai dû y ajouter la ligne :**Categories=Development;Engineering;** | ||
- | Pour le rendre visible dans mon menu sous la catégorie Developpement. | + | Pour le rendre visible dans mon menu sous la catégorie Développement. |
- | That'all fun!!! All work better than the 'apt-get install postgres'! | + | |
+ | ==== Mise à jour Postgres EnterpriseDB avec conservation des Bases de Données ==== | ||
- | ====Mise à jour Postgres EnterpriseDB avec conservation des Bases de Données==== | ||
Supprimer l'ancienne version en lançant le désinstalleur Postgres (dans le dossier Postgres): | Supprimer l'ancienne version en lançant le désinstalleur Postgres (dans le dossier Postgres): | ||
<code> | <code> | ||
$ sudo ./uninstall-postgresql | $ sudo ./uninstall-postgresql | ||
</code> | </code> | ||
- | Le dossier Datas/ n'est pas supprimer. Cela permet de garder nos anciennes base de données et notre configuration utilisateur postgres. | + | Le dossier **Datas/** n'est pas supprimé.\\ Cela permet de garder les anciennes bases de données et la configuration utilisateur postgres.\\ |
- | Lancer le programme d'installation de postgres, après l'avoir télécharger sur le site ci-dessus. | + | Lancer le programme d'installation de postgres, après l'avoir téléchargé sur le site ci-dessus. |
<code> | <code> | ||
$ sudo ./postgresql-version-linux-x64.run | $ sudo ./postgresql-version-linux-x64.run | ||
</code> | </code> | ||
- | Lors de la pré-installation, choisir le chemin du dossier Datas/ qui n'a pas été supprimé. | + | Lors de la pré-installation, choisir le chemin du dossier **Datas/** qui n'a pas été supprimé.\\ |
- | 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 79: | Ligne 87: | ||
<note tip>Il se peut que cette authentification retourne une erreur liée au fait qu'il est impossible pour //postgres// de lire, par exemple, le fichier ~/.bashrc (si un terminal bash est utilisé). La commande //chmod ug+r ~/.bashrc// exécutée avant la connexion postgres réglera ce problème.</note> | <note tip>Il se peut que cette authentification retourne une erreur liée au fait qu'il est impossible pour //postgres// de lire, par exemple, le fichier ~/.bashrc (si un terminal bash est utilisé). La commande //chmod ug+r ~/.bashrc// exécutée avant la connexion postgres réglera ce problème.</note> | ||
- | Désormais, l'invite de commande doit mentionner que vous êtes actif en tant que //postgres//. Pour lancer l'outil d'administration de PostgreSQL, tapez simplement : | + | Désormais, l'invite de commande doit mentionner que vous êtes actif en tant que //postgres//. Pour lancer l'invite de commande SQL de PostgreSQL, tapez simplement : |
<code> | <code> | ||
psql | psql | ||
Ligne 86: | Ligne 94: | ||
Vous devriez obtenir quelque chose comme : | Vous devriez obtenir quelque chose comme : | ||
<code> | <code> | ||
- | psql (9.1.5) | + | psql (13.1-1) |
Type "help" for help. | Type "help" for help. | ||
Ligne 104: | 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_schéma>; | intéressant à faire avant la commande ci-dessous !-)| | ||
+ | ^ \d | liste les tables du schéma courant| | ||
+ | ^ \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 | + | </code> |
- | \g ou point-virgule en fin d'instruction pour exécuter la requête | + | |
- | \q pour quitter | + | et si besoin : |
+ | <code sql> | ||
+ | REVOKE ALL ON SCHEMA mon_schema FROM mon_role; | ||
</code> | </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 155: | Ligne 210: | ||
... | ... | ||
</code> | </code> | ||
- | Puis redémarrez le serveur PostgreSQL: | + | Puis redémarrez le serveur PostgreSQL: |
<code> | <code> | ||
- | $ sudo /etc/init.d/postgresql restart | + | $ sudo service postgresql restart |
</code> | </code> | ||
**Sinon**, si la réponse de ''stat'' est du type : | **Sinon**, si la réponse de ''stat'' est du type : | ||
Ligne 171: | Ligne 226: | ||
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 /etc/init.d/postgresql restart | + | $ sudo service postgresql restart |
</code> | </code> | ||
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". | ||
Ligne 185: | Ligne 240: | ||
=== jeux de caractères par défaut === | === jeux de caractères par défaut === | ||
- | * Connexion en tant qu'utilisateur postgres | + | * Connexion en tant qu'utilisateur postgres |
sudo -i -u postgres | sudo -i -u postgres | ||
Ligne 202: | Ligne 257: | ||
* Identifier la version et le nom de votre cluster | * Identifier la version et le nom de votre cluster | ||
- | + | <code> | |
- | pg_lsclusters | + | $ pg_lsclusters |
Version Cluster Port Status Owner Data directory Log file | 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 | 9.1 main 5432 online postgres /var/lib/postgresql/9.1/main /var/log/postgresql/postgresql-9.1-main.log | ||
+ | </code> | ||
* Supprimer le cluster | * Supprimer le cluster | ||
Ligne 216: | Ligne 271: | ||
* Démarrage | * Démarrage | ||
+ | |||
pg_ctlcluster 9.1 main start | pg_ctlcluster 9.1 main start | ||
Les bases systèmes seront alors conformes aux locales système | Les bases systèmes seront alors conformes aux locales système | ||
- | | + | <code> |
- | psql -l | + | $ psql -l |
List of databases | List of databases | ||
Name | Owner | Encoding | Collate | Ctype | Access privileges | Name | Owner | Encoding | Collate | Ctype | Access privileges | ||
Ligne 229: | Ligne 285: | ||
template1 | postgres | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =c/postgres + | template1 | postgres | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =c/postgres + | ||
| | | | | postgres=CTc/postgres | | | | | | postgres=CTc/postgres | ||
+ | </code> | ||
Ligne 240: | Ligne 296: | ||
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 249: | Ligne 305: | ||
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 264: | Ligne 320: | ||
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 273: | Ligne 329: | ||
</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 280: | Ligne 336: | ||
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 285: | Ligne 342: | ||
=== Méthode alternative pour créer un utilisateur === | === Méthode alternative pour créer un utilisateur === | ||
- | Vous pouvez aussi créer vos utilisateurs directement en ligne de commande, depuis le terminal standard, mais en étant connecté en tant que postgres, bien sûr. | + | Vous pouvez aussi créer vos utilisateurs directement en ligne de commande, depuis le terminal standard. Pour cela, vous allez d'abord autoriser les connexions avec mot de passe chiffré, puis vous vous connecterez en tant que postgres (l'administrateur par défaut de Postgres) et créerez un nouvel utilisateur. |
Cette méthode est beaucoup plus sûre que la précédente. | Cette méthode est beaucoup plus sûre que la précédente. | ||
Ligne 291: | Ligne 348: | ||
(Ce qui n'est pas le cas lorsque l'on emploie la méthode précédente) | (Ce qui n'est pas le cas lorsque l'on emploie la méthode précédente) | ||
- | Il faut d'abord modifier le fichier de configuration pour autoriser les connexions via mot de passe chiffré : | + | 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 299: | Ligne 356: | ||
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 322: | Ligne 379: | ||
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 /etc/init.d/postgresql restart | + | $ sudo service postgresql restart |
</code> | </code> | ||
ou | ou | ||
- | <code> | + | <code bash> |
- | $ sudo pg_ctlcluster 9.1 main restart | + | $ sudo pg_ctlcluster 9.5 main restart |
</code> | </code> | ||
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 343: | Ligne 400: | ||
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 352: | Ligne 409: | ||
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 371: | Ligne 427: | ||
== 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 kate ~/.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): |
- | export PGHOST= <nom_hôte> | + | <code bash> |
- | export PGUSER= <nom_utilisateur> | + | export PGHOST=<nom_hôte> |
+ | 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 394: | Ligne 455: | ||
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 401: | Ligne 462: | ||
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 419: | Ligne 484: | ||
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 427: | Ligne 490: | ||
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 435: | Ligne 498: | ||
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 443: | Ligne 506: | ||
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 451: | Ligne 514: | ||
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 458: | Ligne 521: | ||
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 le paquet [[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 // /usr/share/postgresql/9.1/contrib/postgis-1.5/// | + | ==== DBeaver ==== |
+ | Si vous utilisez d'autres types de base de données, cette solution a l'avantage de les supporter,\\ voir la page [[:dbeaver]] | ||
- | ====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 ===== | ||
+ | ==== Le client pgadmin4 ==== | ||
+ | Outils web graphique d'administration de vos bases | ||
+ | <code bash> | ||
+ | sudo apt install postgresql-common | ||
+ | sudo sh /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh | ||
+ | sudo apt update | ||
+ | sudo apt install postgresql-11 pgadmin4 | ||
+ | </code>((source (EN) [[https://wiki.postgresql.org/wiki/Apt]])) | ||
+ | puis simplement lancer pgadmin4 via le lanceur qui a été ajouté ou en CLI | ||
==== Le client pgadmin3 ==== | ==== Le client pgadmin3 ==== | ||
Ligne 529: | Ligne 548: | ||
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 538: | Ligne 557: | ||
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 548: | Ligne 567: | ||
== 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 587: | Ligne 606: | ||
| [[apt://phppgadmin|{{ :apt.png |Installer en 1 clic.}}]] | | | [[apt://phppgadmin|{{ :apt.png |Installer en 1 clic.}}]] | | ||
- | Réaliser ensuite les opérations suivantes : | + | Réaliser ensuite les opérations suivantes : FIXME (sous [[bionic]], pas de fichier //apache.conf// mais //config.inc.php// ! |
<code> | <code> | ||
sudo ln -s /etc/phppgadmin/apache.conf /etc/apache2/conf.d/phppgadmin.conf | sudo ln -s /etc/phppgadmin/apache.conf /etc/apache2/conf.d/phppgadmin.conf | ||
sudo mv /etc/apache2/conf.d/phppgadmin /etc/apache2/conf-available/phppgadmin.conf | sudo mv /etc/apache2/conf.d/phppgadmin /etc/apache2/conf-available/phppgadmin.conf | ||
sudo a2enconf phppgadmin | sudo a2enconf phppgadmin | ||
- | sudo /etc/init.d/apache2 restart | + | sudo service apache2 restart |
</code> | </code> | ||
Ligne 610: | Ligne 629: | ||
====Connexions vers PHP==== | ====Connexions vers PHP==== | ||
- | PHP 4 : [[:tutoriel/comment_installer_un_paquet|installer]] php4-pgsql. | + | [[:tutoriel/comment_installer_un_paquet|installer|Installer le paquet]] [[apt://php-pgsql|php-pgsql]] |
- | PHP 5 : [[:tutoriel/comment_installer_un_paquet|installer]] php5-pgsql. | + | <note>Il faut recharger Apache après avoir installé ce module : sudo service apache2 reload</note> |
- | + | ||
- | <note>Il faut recharger Apache après avoir installé ce module : sudo /etc/init.d/apache2 reload</note> | + | |
- | + | ||
- | php5-pdo (voir la documentation officielle pour [[http://php.net/pdo|PDO]]) : | + | |
- | <code>sudo pear install pecl-pdo_pgsql</code> | + | |
- | + | ||
- | PHP 5.2 : cela se fait automatiquement. | + | |
- | + | ||
- | > FIXME : à compléter. | + | |
+ | Activer ce module | ||
+ | <code>sudo phpenmod pdo_pgsql</code> | ||
+ | Redémarrer apache2 | ||
====Pool de connexion : PgBouncer==== | ====Pool de connexion : PgBouncer==== | ||
[[pgbouncer|PgBouncer]] | [[pgbouncer|PgBouncer]] | ||
Ligne 678: | Ligne 691: | ||
</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 ===== | ||
+ | La société Dalibo mets ses support de cours à disposition ([[https://creativecommons.org/licenses/by-nc-sa/2.0/fr/|CC BY NC SA]]):\\ | ||
+ | [[https://www.dalibo.com/formations]]\\ | ||
+ | sous l'intitulé de chaque formation, vous trouvez les liens pour télécharger le support au format [[pdf|PDF]] ou [[epub|EPUB]]\\ | ||
+ | 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> | ||
---- | ---- | ||
- | //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]] // |