For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/databases/postgresql-connect-cli.md.

Se connecter avec la CLI au service Public Cloud Databases pour PostgreSQL

Voir en Markdown

Connectez-vous à votre service Public Cloud Databases pour PostgreSQL à l'aide de la Command Line Interface (CLI)

Objectif

Public Cloud Databases vous permet de vous concentrer sur la création et le déploiement de vos applications cloud, pendant qu'OVHcloud prend en charge l'infrastructure de base de données et son maintien en conditions opérationnelles.

Ce guide explique comment se connecter à une instance de base de données PostgreSQL à l'aide d'une Command Line Interface (CLI).

Prérequis

Concept

Une instance PostgreSQL peut être gérée de plusieurs façons. L'une des méthodes les plus simples, mais aussi des plus puissantes, consiste à utiliser une Command Line Interface (CLI), également appelée console ou terminal.

Pour interagir correctement avec l'instance PostgreSQL, nous devons d'abord installer ce que l'on appelle un client PostgreSQL, afin de nous connecter et de contrôler le service PostgreSQL à distance. Il s'agit d'une interaction client-serveur.

Votre service expose deux points d'entrée distincts : le port du service, sur lequel chaque connexion cliente ouvre un processus dédié côté serveur, et, si vous en avez créé un, le port d'un pool de connexion, qui mutualise les connexions clientes sur un nombre réduit de connexions serveur. Ce guide décrit la connexion directe au service. La syntaxe est identique pour un pool : seuls le port et le nom de base de données changent.

Accès à l'espace client OVHcloud

  • Lien direct :
  • Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Databases

En pratique

Installer le client PostgreSQL

Info

Veuillez noter que PostgreSQL-Client est nativement intégré au package logiciel PostgreSQL.

Vous devez d'abord installer un logiciel permettant d'interagir avec votre instance PostgreSQL à distance. Ce logiciel officiel peut être installé sur diverses machines clientes, telles que votre propre ordinateur, un VPS ou une machine virtuelle. La seule règle est de pouvoir accéder au réseau public (Internet) et de disposer des droits suffisants pour l'installer.

Pour ce faire, et selon votre configuration, vous devrez peut-être suivre la documentation officielle de PostgreSQL pour installer le client PostgreSQL (appelé psql).

Suivez les étapes ici après avoir sélectionné Windows, MacOS ou Linux comme système d'exploitation : https://www.postgresql.org/download/

Comme expliqué, le postgresql-client est souvent inclus par défaut.

Exemple avec Linux/Debian :

Debian postgresql-client

Nous allons maintenant suivre la documentation officielle de PostgreSQL pour effectuer notre première connexion.

Dans votre CLI, tapez psql --version. Le résultat devrait ressembler à ceci :

$ psql --version
psql (PostgreSQL) 18.0 (Ubuntu 18.0-1)

Cela signifie que psql est correctement installé et fonctionne correctement. Si vous n'obtenez pas un résultat similaire, veuillez revenir à l'étape précédente et réinstaller le client PostgreSQL.

Se connecter à votre instance PostgreSQL

Nous allons suivre la documentation officielle de PostgreSQL : https://www.postgresql.org/docs/devel/app-psql.html.

Pour effectuer une connexion, tapez simplement psql suivi de l'URI de service copié précédemment :

$ psql "postgres://<username>:<password>@<hostname>:<port>/defaultdb?sslmode=require"

N'oubliez pas de modifier le nom d'utilisateur, le mot de passe, le nom d'hôte et le port. Dans notre exemple, cela ressemblera à ceci :

$ psql "postgres://avnadmin:Mysup3rs3cur3p4ssw0rd@postgresql-ab123456-cd7891011.database.cloud.ovh.net:20184/defaultdb?sslmode=require"

Une fois connecté correctement, vous devriez voir quelque chose de similaire à :

psql (18.0 (Ubuntu 18.0-1))
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, compression: off, ALPN: postgresql)
Type "help" for help.

defaultdb=>
Tip

Félicitations ! Vous êtes désormais pleinement en mesure d'interagir avec votre instance PostgreSQL !

Warning

L'URI proposé dans l'espace client utilise sslmode=require : la connexion est chiffrée, mais votre client ne vérifie pas l'identité du serveur. Pour un usage en production, utilisez sslmode=verify-full avec le certificat CA de votre service, comme décrit à la section suivante.

Vérifier l'identité du serveur

La section Informations de connection de l'onglet Dashboard fournit le certificat CA de votre service, dans le champ Certificat. Avec ce certificat, votre client peut vérifier qu'il parle bien à votre service et non à un intermédiaire :

$ psql "postgres://<username>:<password>@<hostname>:<port>/defaultdb?sslmode=verify-full&sslrootcert=/chemin/vers/ca.pem"

Consultez le guide « Sécuriser la connexion TLS » pour la procédure complète, la gestion du renouvellement du certificat et les exemples de configuration par langage.

Utilisation du client PostgreSQL

Une fois connecté, vous pouvez gérer votre instance PostgreSQL à l'aide des méthodes intégrées du client PostgreSQL.

Veuillez suivre la documentation officielle de PostgreSQL.

Pour vérifier :

  • \h CREATE DATABASE affichera l'aide sur une commande spécifique (ici pour CREATE DATABASE) ;
  • \l+ listera toutes les bases de données ;
  • select * from pg_user; affichera des informations sur les utilisateurs existants.

Dans notre exemple, cela ressemblera à ceci :

defaultdb=> \h CREATE DATABASE
Command:     CREATE DATABASE
Description: create a new database
Syntax:
CREATE DATABASE name
    [ WITH ] [ OWNER [=] user_name ]
           [ TEMPLATE [=] template ]
           [ ENCODING [=] encoding ]
           [ STRATEGY [=] strategy ]
           [ LOCALE [=] locale ]
           [ LC_COLLATE [=] lc_collate ]
           [ LC_CTYPE [=] lc_ctype ]
           [ BUILTIN_LOCALE [=] builtin_locale ]
           [ ICU_LOCALE [=] icu_locale ]
           [ ICU_RULES [=] icu_rules ]
           [ LOCALE_PROVIDER [=] locale_provider ]
           [ COLLATION_VERSION = collation_version ]
           [ TABLESPACE [=] tablespace_name ]
           [ ALLOW_CONNECTIONS [=] allowconn ]
           [ CONNECTION LIMIT [=] connlimit ]
           [ IS_TEMPLATE [=] istemplate ]
           [ OID [=] oid ]

URL: https://www.postgresql.org/docs/18/sql-createdatabase.html
defaultdb=> \l+
                                                                List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    |   Access privileges   |  Size   | Tablespace |            Description
-----------+----------+----------+-------------+-------------+-----------------------+---------+------------+------------------------------------
 _aiven    | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 |                       | 8269 kB | pg_default |
 defaultdb | avnadmin | UTF8     | en_US.UTF-8 | en_US.UTF-8 |                       | 12 MB   | pg_default |
 template0 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +| 8253 kB | pg_default | unmodifiable empty database
           |          |          |             |             | postgres=CTc/postgres |         |            |
 template1 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +| 8229 kB | pg_default | default template for new databases
           |          |          |             |             | postgres=CTc/postgres |         |            |
(4 rows)
defaultdb=> select * from pg_user;
  usename  | usesysid | usecreatedb | usesuper | userepl | usebypassrls |  passwd  | valuntil | useconfig
-----------+----------+-------------+----------+---------+--------------+----------+----------+-----------
 postgres  |       10 | t           | t        | t       | t            | ******** |          |
 _aiven    |    16399 | f           | t        | t       | f            | ******** |          |
 avnadmin  |    16400 | t           | f        | t       | t            | ******** |          |
(3 rows)

Aller plus loin

Capacités de PostgreSQL

Démarrer avec Public Cloud Databases

Sécuriser la connexion TLS

Créer et utiliser des pools de connexion

Gérer les utilisateurs, rôles et privilèges

Consultez le dépôt d'exemples Github pour découvrir comment vous connecter à votre base de données dans plusieurs langages.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Votre avis nous intéresse !

Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.

Vous êtes sur Discord ? Rejoignez notre chaîne via https://discord.gg/ovhcloud et interagissez directement avec l’équipe qui développe notre service de bases de données !

Cette page vous a-t-elle aidé ?