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/mysql-connect-cli.md.
Aller au contenu

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

Voir en Markdown

Connectez-vous à votre service Public Cloud Databases pour MySQL à l'aide de l'interface en ligne de commande (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 MySQL à l'aide d'une interface en ligne de commande (CLI).

Prérequis

Concept

Pour interagir correctement avec l'instance MySQL, nous devons d'abord installer un élément appelé client MySQL, afin de nous connecter et de contrôler le service MySQL à distance. Il s'agit d'une interaction client-serveur.

En pratique

Installation du client MySQL

Info

Veuillez noter qu'un client MySQL est nativement intégré au package logiciel MySQL, mais qu'il ne permet pas l'utilisation d'un Service URI.

Vous devez d'abord installer un logiciel pour interagir avec votre instance MySQL à 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 MySQL pour installer MySQL Shell (mysqlsh), plus puissant que MySQL Client (mysql).

MySQL Shell n'est pas obligatoire, mais bien plus pratique à utiliser que les clients MySQL standards, car il permet de se connecter avec un Service URI plutôt qu'avec des paramètres individuels.

Suivez les étapes ci-après en sélectionnant Windows, macOS ou Linux comme système d'exploitation : https://dev.mysql.com/doc/mysql-shell/8.4/en/mysql-shell-install.html.

Nous sommes maintenant prêts à apprendre comment nous connecter à notre instance MySQL.

Configuration

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

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

laptop$mysqlsh --version
/snap/mysql-shell/29/bin/mysqlsh   Ver 8.0.23 for Linux on x86_64 - for MySQL 8.0.23 (Source distribution)

Cela signifie que mysqlsh est correctement installé et fonctionne normalement. Si vous n'obtenez pas un résultat similaire à celui-ci, revenez à l'étape précédente et réinstallez MySQL Shell.

Se connecter à votre instance MySQL

Nous allons suivre la documentation officielle de MySQL : https://dev.mysql.com/doc/refman/8.4/en/connecting-using-uri-or-key-value-pairs.html.

Pour effectuer une connexion, saisissez simplement mysqlsh --sql suivi du Service URI :

laptop$mysqlsh --sql "mysql://<username>:<password>@<hostname>:<port>/defaultdb?ssl-mode=REQUIRED"

N'oubliez pas de modifier le nom d'utilisateur, le mot de passe, le nom d'hôte et le port. Vous trouverez l'hôte, le port et l'URI de votre service dans la carte Détails de connexion de l'onglet Vue d'ensemble. Le port est propre à chaque service : ne réutilisez pas celui de l'exemple ci-dessous. Dans notre exemple, cela ressemblera à ceci :

laptop$mysqlsh --sql "mysql://avnadmin:Mysup3rs3cur3p4ssw0rd@mysql-ab123456-cd7891011.database.cloud.ovh.net:20184/defaultdb?ssl-mode=REQUIRED"

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

MySQL Shell 8.0.23

Copyright (c) 2016, 2021, Oracle and/or its affiliates.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
Other names may be trademarks of their respective owners.

Type '\help' or '\?' for help; '\quit' to exit.
WARNING: Using a password on the command line interface can be insecure.
Creating a Classic session to '.(removed)..:20184/defaultdb?ssl-mode=REQUIRED'
Fetching schema names for autocompletion... Press ^C to stop.
Fetching table and column names from `defaultdb` for auto-completion... Press ^C to stop.
Your MySQL connection id is 50811
Server version: 8.0.26 Source distribution
Default schema set to `defaultdb`.
mysql-sql [defaultdb]>

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

Warning

Si la connexion reste bloquée puis échoue à l'expiration du délai d'attente, vérifiez que l'adresse IP de votre client est autorisée sur votre service (consultez le guide « Configurez les connexions entrantes d'un service Public Cloud Databases pour MySQL »). Tant qu'aucune adresse IP n'est autorisée, le service reste injoignable, même s'il apparaît comme disponible.

Warning

L'URI fournie dans la console OVHcloud utilise ssl-mode=REQUIRED : la connexion est chiffrée, mais votre client ne vérifie pas l'identité du serveur. Pour un usage en production, vérifiez-la avec le certificat CA de votre service, comme décrit dans la section suivante.

Vérifier l'identité du serveur

La carte Détails de connexion de l'onglet Vue d'ensemble fournit le certificat CA de votre service, dans le champ Certificat CA. Téléchargez-le, puis transmettez-le à votre client avec le mode VERIFY_IDENTITY : le client vérifie que le certificat du serveur est signé par cette CA et qu'il correspond au nom d'hôte auquel vous vous connectez.

Exemple avec le client MySQL (mysql), qui utilise des paramètres individuels plutôt qu'une URI :

laptop$mysql --host=<hostname> --port=<port> --user=<username> --password --database=defaultdb --ssl-mode=VERIFY_IDENTITY --ssl-ca=/path/to/ca.pem
Info

L'option --ssl-mode est propre au client MySQL d'Oracle. Le client MariaDB, installé sous le nom mysql par certaines distributions Linux, ne la prend pas en charge.

Utilisation du client MySQL

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

Veuillez suivre la documentation officielle de MySQL.

Pour vérifier :

  • SHOW DATABASES; listera toutes les bases de données ;
  • select * from mysql.user; affichera les informations sur les utilisateurs existants.

Dans notre exemple, cela ressemblera à ceci :

mysql-sql [defaultdb]> SHOW DATABASES;
+--------------------+
| Database           |
+--------------------+
| defaultdb          |
| information_schema |
| mysql              |
| performance_schema |
| sys                |
+--------------------+
5 rows in set (0.0046 sec)
mysql-sql [defaultdb]> \h CREATE DATABASE
CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] db_name
    [create_option] ...

create_option: [DEFAULT] {
    CHARACTER SET [=] charset_name
  | COLLATE [=] collation_name
  | ENCRYPTION [=] {'Y' | 'N'}
}

URL: https://dev.mysql.com/doc/refman/8.0/en/create-database.html

Aller plus loin

Capacités de MySQL

Prise en main de Public Cloud Databases

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

Votre avis nous intéresse !

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

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.

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é ?