Guide du débutant ! Comment installer et configurer PostgreSQL sur Ubuntu

1. Introduction

PostgreSQL est une base de données relationnelle très stable et très performante, largement utilisée dans diverses applications et systèmes sous Ubuntu. Cet article propose un guide clair, étape par étape, pour installer et configurer PostgreSQL sur Ubuntu. Il est destiné aux débutants, expliquant chaque étape en détail et incluant des instructions pour vérifier l’installation et résoudre les erreurs de connexion, afin que vous puissiez configurer votre environnement en toute confiance.

2. Prérequis et préparation

Tout d’abord, assurez‑vous que votre version d’Ubuntu est soit 20.04 soit 22.04. Avant d’installer PostgreSQL, mettez à jour votre liste de paquets pour récupérer les dernières informations sur les paquets.

sudo apt update

Cette étape contribue à garantir un processus d’installation fluide.

3. Installation de PostgreSQL

3.1 Ajout du dépôt PostgreSQL

Le dépôt Ubuntu par défaut ne contient pas toujours la dernière version de PostgreSQL. Pour installer la version la plus récente, ajoutez le dépôt officiel de PostgreSQL.

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo wget -qO- https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/trusted.gpg.d/pgdg.asc

3.2 Installation de PostgreSQL

Après avoir ajouté le dépôt, installez PostgreSQL et les outils supplémentaires en utilisant la commande suivante :

sudo apt update
sudo apt install postgresql postgresql-contrib

3.3 Vérification de l’installation

Une fois l’installation terminée, vérifiez la version de PostgreSQL pour vous assurer qu’elle a été installée correctement.

postgres --version

 

4. Configuration initiale

4.1 Configuration de l’utilisateur PostgreSQL

Lorsque PostgreSQL est installé, un utilisateur système nommé postgres est créé automatiquement. Passez à cet utilisateur pour gérer la base de données avec la commande suivante :

sudo -i -u postgres

4.2 Modification des paramètres de connexion locale

Modifiez le fichier pg_hba.conf pour configurer les paramètres d’authentification. Par défaut, seules les connexions locales sont autorisées. Pour activer les connexions à distance, éditez le fichier suivant :

sudo nano /etc/postgresql/14/main/pg_hba.conf

Par exemple, vous pouvez renforcer la sécurité en spécifiant l’authentification md5 comme suit :

local   all             postgres                                md5
host    all             all             127.0.0.1/32            md5

Après avoir effectué les modifications, redémarrez le service PostgreSQL pour appliquer les nouveaux paramètres :

sudo systemctl restart postgresql

5. Quick Functionality Check

5.1 Starting and Stopping PostgreSQL

PostgreSQL démarre automatiquement après l’installation. Cependant, vous pouvez démarrer, arrêter ou vérifier l’état du service manuellement en utilisant les commandes suivantes :

sudo systemctl status postgresql
sudo systemctl start postgresql
sudo systemctl stop postgresql

5.2 Checking the Database

Utilisez la commande psql pour vous connecter à PostgreSQL et vérifier la liste des bases de données disponibles.

sudo -u postgres psql

Une fois dans l’invite PostgreSQL, tapez l pour afficher la liste des bases de données.

6. Installation et configuration de pgAdmin (Optionnel)

pgAdmin est un outil graphique qui facilite la gestion de PostgreSQL. Installez-le en utilisant la commande suivante :

sudo apt install pgadmin4

Après l’installation, ouvrez un navigateur et accédez http://localhost/pgadmin pour commencer à gérer PostgreSQL via l’interface graphique.

7. Dépannage et erreurs courantes

7.1 Erreurs d’installation et de dépôt

Si vous rencontrez des erreurs de dépendance ou de dépôt lors de l’installation, vérifiez que l’URL du dépôt est correcte et mettez à jour la liste des paquets à nouveau.

sudo apt update

7.2 Correction des erreurs de connexion

Si vous obtenez une erreur telle que « échec de l’authentification par mot de passe » lors de la connexion à PostgreSQL, vérifiez vos paramètres pg_hba.conf et confirmez votre mot de passe. Redémarrez le service PostgreSQL après avoir effectué les modifications.

sudo systemctl restart postgresql

7.3 Résolution des problèmes réseau

Si les connexions à distance ne fonctionnent pas, vérifiez le fichier postgresql.conf afin de vous assurer que listen_addresses n’est pas défini sur « localhost ». Pour autoriser les connexions à distance, modifiez le paramètre comme suit :

sudo nano /etc/postgresql/14/main/postgresql.conf

Modifiez le paramètre ainsi :

listen_addresses = '*'

Après avoir effectué cette modification, redémarrez le service PostgreSQL pour appliquer la mise à jour.

sudo systemctl restart postgresql

 

8. Conclusion

Dans cet article, nous avons couvert comment installer PostgreSQL sur Ubuntu, effectuer la configuration initiale et vérifier son fonctionnement. Nous avons également abordé l’utilisation de pgAdmin, l’activation des connexions à distance et le dépannage des erreurs courantes. En suivant ces étapes, même les débutants peuvent installer et gérer leur environnement PostgreSQL en toute confiance.

MySQL & MariaDBの世界

目次 1 1. はじめに2 2. MySQLとPostgreSQLの基本的な違い2.1 MySQLの概要2.2 Post…

侍エンジニア塾