MySQL::MySQL 8.0 Manuel de référence :: 4.2.4 Connexion au Serveur MySQL À l’aide des Options de commande

Cette section décrit l’utilisation des options de ligne de commande pour spécifier comment établir des connexions au serveur MySQL, pour des clients tels que mysql ou mysqldump. Pour plus d’informations sur l’établissement de connexions à l’aide de chaînes de connexion de type URI ou de paires clé-valeur, pour des clients tels que le shell MySQL, reportez-vous à la section 4.2.5,  » Connexion au serveur à l’aide de chaînes de connexion de type URI ou de paires Clé-Valeur ”. Pour plus d’informations si vous ne parvenez pas à vous connecter, reportez-vous à la section 6.2.21, « Dépannage des problèmes de connexion à MySQL”.

Pour qu’un programme client se connecte au serveur MySQL, il doit utiliser les paramètres de connexion appropriés, tels que le nom de l’hôte sur lequel le serveur s’exécute et le nom d’utilisateur et le mot de passe de votre compte MySQL. Chaque paramètre de connexion a une valeur par défaut, mais vous pouvez remplacer les valeurs par défaut si nécessaire en utilisant les options du programme spécifiées sur la ligne de commande ou dans un fichier d’options.

Les exemples ici utilisent le programme client mysql, mais les principes s’appliquent à d’autres clients tels que mysqldump, mysqladmin ou mysqlshow.

Cette commande appelle mysql sans spécifier de paramètres de connexion explicites :

mysql

Comme il n’y a pas d’options de paramètres, les valeurs par défaut s’appliquent :

Pour spécifier explicitement le nom d’hôte et le nom d’utilisateur, ainsi qu’un mot de passe, fournissez les options appropriées sur la ligne de commande. Pour sélectionner une base de données par défaut, ajoutez un argument database-name. Exemples :

mysql --host=localhost --user=myname --password=password mydbmysql -h localhost -u myname -ppassword mydb

Pour les options de mot de passe, la valeur du mot de passe est facultative :

Comme nous venons de le mentionner, inclure la valeur du mot de passe sur la ligne de commande est un risque de sécurité. Pour éviter ce risque, spécifiez l’option --password ou -p sans valeur de mot de passe suivante:

mysql --host=localhost --user=myname --password mydbmysql -h localhost -u myname -p mydb

Lorsque l’option --password ou -p est donnée sans valeur de mot de passe, le programme client affiche une invite et attend que vous entrez le mot de passe. (Dans ces exemples, mydb n’est pas interprété comme un mot de passe car il est séparé de l’option de mot de passe précédente par un espace.)

Sur certains systèmes, la routine de bibliothèque utilisée par MySQL pour demander un mot de passe limite automatiquement le mot de passe à huit caractères. Cette limitation est une propriété de la bibliothèque système, pas de MySQL. En interne, MySQL n’a aucune limite pour la longueur du mot de passe. Pour contourner la limitation des systèmes concernés, spécifiez votre mot de passe dans un fichier d’options (voir Section 4.2.2.2, « Utilisation des fichiers d’options”). Une autre solution consiste à changer votre mot de passe MySQL en une valeur de huit caractères ou moins, mais qui présente l’inconvénient que les mots de passe plus courts ont tendance à être moins sécurisés.

Les programmes clients déterminent le type de connexion à établir comme suit:

L’option --protocol vous permet d’utiliser un protocole de transport particulier même lorsque d’autres options entraînent normalement l’utilisation d’un protocole différent. Autrement dit, --protocol spécifie explicitement le protocole de transport et remplace les règles précédentes, même pour localhost.

Seules les options de connexion pertinentes pour le protocole de transport sélectionné sont utilisées ou cochées. Les autres options de connexion sont ignorées. Par exemple, avec --host=localhost sous Unix, le client tente de se connecter au serveur local à l’aide d’un fichier de socket Unix, même si une option --port ou -P est donnée pour spécifier un numéro de port TCP/IP.

Pour s’assurer que le client établit une connexion TCP/IP au serveur local, utilisez --host ou -h pour spécifier une valeur de nom d’hôte de 127.0.0.1 (au lieu de localhost), ou l’adresse IP ou le nom du serveur local. Vous pouvez également spécifier explicitement le protocole de transport, même pour localhost, en utilisant l’option --protocol=TCP. Exemple:

mysql --host=127.0.0.1mysql --protocol=TCP

Si le serveur est configuré pour accepter les connexions IPv6, les clients peuvent se connecter au serveur local via IPv6 en utilisant --host=::1. Voir la section 5.1.13,  » Prise en charge d’IPv6″.

Sous Windows, pour forcer un client MySQL à utiliser une connexion de canal nommé, spécifiez l’option --pipe ou --protocol=PIPE, ou spécifiez . (point) comme nom d’hôte. Si le serveur n’a pas été démarré avec la variable système named_pipe activée pour prendre en charge les connexions de tuyaux nommés ou si l’utilisateur effectuant la connexion n’est pas membre du groupe Windows spécifié par la variable système named_pipe_full_access_group, une erreur se produit. Utilisez l’option --socket pour spécifier le nom du tuyau si vous ne souhaitez pas utiliser le nom du tuyau par défaut.

Les connexions aux serveurs distants utilisent TCP/IP. Cette commande se connecte au serveur s’exécutant sur remote.example.com en utilisant le numéro de port par défaut (3306):

mysql --host=remote.example.com

Pour spécifier explicitement un numéro de port, utilisez l’option --port ou -P :

mysql --host=remote.example.com --port=13306

Vous pouvez spécifier un numéro de port pour les connexions à un serveur local aussi. Cependant, comme indiqué précédemment, les connexions à localhost sous Unix utilisent un fichier socket par défaut, donc à moins que vous ne forciez une connexion TCP/IP comme décrit précédemment, toute option spécifiant un numéro de port est ignorée.

Pour cette commande, le programme utilise un fichier socket sous Unix et l’option --port est ignorée :

mysql --port=13306 --host=localhost

Pour que le numéro de port soit utilisé, forcez une connexion TCP/IP. Par exemple, appelez le programme de l’une des manières suivantes :

mysql --port=13306 --host=127.0.0.1mysql --port=13306 --protocol=TCP

Pour plus d’informations sur les options qui contrôlent la façon dont les programmes clients établissent des connexions au serveur, voir Section 4.2.3,  » Options de commande pour la connexion au serveur”.

Il est possible de spécifier des paramètres de connexion sans les saisir sur la ligne de commande chaque fois que vous appelez un programme client :