Skip navigation links
MySQL 5.0 Reference Manual :: 8 MySQL Scripts clients et utilitaires :: 8.4 mysqladmin, administration d'un serveur MySQL
8.5 mysqlbinlog, Exécuter des requêtes dans le log binaire »
Section Navigation      [Toggle]

8.4. mysqladmin, administration d'un serveur MySQL

mysqladmin est un utilitaire pour exécuter des commandes d'administration. Vous pouvez l'utiliser pour vérifier la configuration du serveur, créer et effacer des bases, etc.

La syntaxe de mysqladmin est : 

shell> mysqladmin [OPTIONS] command [command-option] command ...

Le mysqladmin actuel supporte les commandes suivantes :

  • create databasename

    Crée une nouvelle base.

  • drop databasename

    Efface une base et toutes ces tables.

  • extended-status

    Affiche un message de statut du serveur très complet.

  • flush-hosts

    Vide tous les hôtes mis en cache.

  • flush-logs

    Vide de la mémoire tous les logs.

  • flush-privileges

    Recharger les tables de droits (identique à la commande reload).

  • flush-status

    Remet à zéro les variables de statut.

  • flush-tables

    Vide de la mémoire toutes les tables.

  • flush-threads

    Vide les threads de cache. Nouveau en MySQL 3.23.16.

  • kill id,id,...

    Termine un thread MySQL.

  • password new-password

    Spécifie un nouveau mot de passe. Modifie l'ancien mot de passe en new-password pour le compte que vous utilisez lors de la connexion avec mysqladmin.

  • ping

    Vérifie si mysqld fonctionne ou pas.

  • processlist

    Affiche la liste des processus du serveur. Cela revient à la commande SHOW PROCESSLIST. Si --verbose est utilisé, le résultat est le même que SHOW FULL PROCESSLIST.

  • reload

    Recharge les tables de droits.

  • refresh

    Vide de la mémoire toutes les tables, puis ferme et réouvre les fichiers de logs.

  • shutdown

    Eteind le serveur.

  • slave-start

    Démarre l'esclave de réplication.

  • status

    Affiche le message de statut court du serveur.

  • slave-stop

    Eteind l'esclave de réplication.

  • variables

    Affiche les variable disponibles.

  • version

    Affiche la version du serveur.

Toutes les commandes peuvent être réduites à leur préfixe simple. Par exemple : 

shell> mysqladmin proc stat
+----+-------+-----------+----+-------------+------+-------+------+
| Id | User  | Host      | db | Command     | Time | State | Info |
+----+-------+-----------+----+-------------+------+-------+------+
| 6  | monty | localhost |    | Processlist | 0    |       |      |
+----+-------+-----------+----+-------------+------+-------+------+
Uptime: 10077  Threads: 1  Questions: 9  Slow queries: 0
Opens: 6 Flush tables: 1  Open tables: 2
Memory in use: 1092K  Max memory used: 1116K

La commande mysqladmin status liste les colonnes suivantes :

  • Uptime

    Nombre de secondes de vie du serveur MySQL.

  • Threads

    Nombre de threads actifs (clients).

  • Questions

    Nombre de questions re¸u des clients depuis le démarrage de mysqld.

  • Slow queries

    Nombre de requêtes qui ont pris plus de long_query_time secondse. See Section 5.9.5, « Le log des requêtes lentes ».

  • Opens

    Combien de tables sont ouvertes par mysqld.

  • Flush tables

    Nombre de commandes flush ..., refresh et reload.

  • Open tables

    Nombre de tables qui sont ouvertes actuellement.

  • Memory in use

    Mémoire allouée directement par mysqld (uniquement disponible si MySQL a été compilé avec l'option --with-debug=full).

  • Maximum memory used

    Maximum de mémoire allouée directement par mysqld (uniquement disponible si MySQL a été compilé avec l'option --with-debug=full).

Si vous exécutez mysqladmin shutdown en vous connectant à un serveur local, avec un fichier de socket Unix, mysqladmin va attendre que le fichier de processus du serveur soit supprimé, pour s'assurer que le serveur est bien arrété.

mysqladmin supporte les options suivantes :

  • --help, -?

    Affiche le message d'aide et quitte.

  • --character-sets-dir=path

    Le dossier où les jeux de caractères sont stockés. See Section 5.8.1, « Le jeu de caractères utilisé pour les données et le stockage ».

  • --compress, -C

    Compresse toutes les informations entre le client et le serveur, si les deux le supporte.

  • --count=#, -c #

    Le nombre d'itération à faier. Cela fonctionne uniquement avec --sleep (-i).

  • --debug[=debug_options], -# [debug_options]

    Écrit un log de débogage. La chaîne debug_options est souvent 'd:t:o,file_name'. La valeur par défaut est 'd:t:o,/tmp/mysqladmin.trace'.

  • --force, -f

    Ne demande pas de confirmation pour la commande drop database. Avec des commandes multiples, continue même si une erreur survient.

  • --host=host_name, -h host_name

    Connexion au serveur MYSQL avec le nom d'hôte donné.

  • --password[=password], -p[password]

    Le mot de passe utilisé lors de la connexion sur le serveur. S'il n'est pas donné en ligne de commande, il sera demandé interactivement. Notez que si vous utilisez la forme courte -p, vous ne devez pas laisser d'espace entre l'option et le mot de passe.

  • --port=port_num, -P port_num

    Le numéro de port TCP/IP pour la connexion.

  • --protocol={TCP | SOCKET | PIPE | MEMORY}

    Spécifie le protocole de connexion à utiliser. Nouveau en MySQL 4.1.

  • --relative, -r

    Affiche la différence entre la valeur courante et la valeur précédente, lorsqu'utilisé avec l'option -i. Actuellement, cette option fonctionne avec la commande extended-status.

  • --silent, -s

    Mode très silencieux.

  • --sleep=delay, -i delay

    Exécute les commandes encore et encore, avec delay secondes entre deux.

  • --socket=path, -S path

    Le fichier de socket à utiliser pour la connexion.

  • --user=user_name, -u user_name

    Nom d'utilisateur pour la connexion, si ce n'est pas l'utilisateur Unix courant.

  • --verbose, -v

    Affichage plus détaillé (-v -v -v indique le format d'affichage de table).

  • --version, -V

    Affiche la version et quitte.

  • --vertical, -E

    Print output vertically. This is similar to --relative, but prints output vertically.

  • --wait[=#], -w[#]

    Si la connexion n'a pu être établie, attent et ressaie au lieu d'abandonner. Si une valeur est spécifiée, elle indique le nombre de tentatives. La valeur par défaut est 1 fois.

Vous pouvez aussi configurer ces options avec la syntaxe --var_name=value :

  • connect_timeout

    Le nombre de secondes avant une éxpiration de connexion. (Par défaut, 0.)

  • shutdown_timeout

    Le nombre de seconde d'attente de l'extinction. (Par défaut, 0.)

Il est aussi possible de configurer les variables en utilisant --set-variable=var_name=value ou la syntaxe -O var_name=value. Cependant, cette syntaxe est obsolète depuis MySQL 4.0.

This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.