5.2.1 Options de ligne de commande de mysqld

mysqld et mysqld.server lisent les options des groupes mysqld et server . mysqld_safe lit les options des groupes mysqld , server , mysqld_safe et safe_mysqld . Un serveur MySQL intégré lit généralement les options dans les groupes server , embedded et xxxxx_SERVER , où xxxxx est le nom de l'application.

La liste suivante montre les options de serveur les plus courantes. Les options supplémentaires sont détaillées ailleurs.

• Options qui affectent la sécurité : voir Options de démarrage de mysqld qui concernent la sécurité .
• Options liées à SSL : voir Options de ligne de commande pour SSL .
• Options de contrôle des logs binaires : voir Le log binaire des mises à jour .
• Options de réplication : voir Options de réplication .
• Options spécifiques à un moteur de table particulier : voir Options de démarrage MyISAM , Options de démarrage BDB , Options de démarrage InnoDB .

--help , -?

Affiche l'aide courte et termine le programme. Avant MySQL 4.1.1, --help affiche un message d'aide complet. Depuis 4.1.1, il affiche un bref message. Pour voir la liste complète, utilisez mysqld --verbose --help .

--ansi

Utilise la syntaxe ANSI SQL au lieu de la syntaxe MySQL. Exécuter MySQL en mode ANSI . Pour un contrôle plus précis sur le mode SQL serveur, utilisez l'option --sql-mode .

--basedir=path , -b path

Chemin jusqu'au dossier d'installation. Tous les chemins sont généralement relatifs à celui-ci.

--big-tables

Autorise la sauvegarde de grands résultats dans des fichiers temporaires. Cela résout le problème des erreurs " table full ", mais ralentit les requêtes alors que des tables en mémoire suffirait. Depuis la version version 3.23.2, MySQL est capable de résoudre automatiquement ce problème en utilisant de la mémoire pour toutes les tables temporaires de petite taille, et en passant sur le disque au besoin.

--bind-address=IP

L'adresse IP à utiliser.

--console

Ecrit les messages d'erreurs du log d'erreur sur la sortie standard, même si --log-error est spécifiée. Sous Windows, mysqld ne ferme pas l'écran de console si cette option est utilisée.

--character-sets-dir=path

Dossier contenant les jeux de caractères. Le jeu de caractères utilisé pour les données et le stockage .

--chroot=path

Met le démon mysqld en environnement chroot au démarrage. Recommandé pour la sécurité depuis MySQL 4.0. (MySQL 3.23 n'est pas capable de fournir un encadrement chroot() qui soit 100% étanche). Cela limite les commandes LOAD DATA INFILE et SELECT ... INTO OUTFILE .

--core-file

Ecrire le fichier core lorsque mysqld s'arrête inopinément. Pour certains fichiers, vous devez aussi spécifier --core-file-size à safe_mysqld . safe_mysqld , le script père de mysqld . Notez que sur certains systèmes, comme Solaris, vous n'aurez pas de fichier de core si vous avez aussi utilisé l'option --user .

--datadir=path , -h path

Chemin jusqu'au dossier de données.

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

Si MySQL est configuré avec --with-debug , vous pouvez utiliser cette option pour obtenir un fichier de trace de ce que mysqld fait. Créer des fichiers de traçage .

--default-character-set=charset

Spécifie le jeu de caractères par défaut. Le jeu de caractères utilisé pour les données et le stockage .

--default-collation=collation

Spécifie la collation par défaut. Cette option est disponible depuis MySQL 4.1.1. Le jeu de caractères utilisé pour les données et le stockage .

--default-storage-engine=type

Cette option est un synonyme de --default-table-type . Cette option est disponible depuis MySQL 4.1.2.

--default-table-type=type

Spécifie le type de table par défaut. Types de tables MySQL .

--delay-key-write[= OFF | ON | ALL]

Comment l'option DELAYED KEYS doit être utilisée. Les écritures différées font que les buffers de clés ne sont pas écrits entre deux écriture pour les tables MyISAM . OFF désactive les écritures différées. ON active les écritures différées pour les tables qui ont été créées avec l'option DELAYED KEYS . ALL active les écritures différées pour les tables MyISAM . Cette option est disponible depuis MySQL 4.0.3. Choix des paramètres du serveur . Options de démarrage MyISAM .

Note : Si vous avez donné la valeur de ALL à cette option, vous ne devez pas utiliser les tables MyISAM depuis un autre programme (comme myisamchk ) lorsque la tables utilisée. En faisant cela, vous obtiendrez une corruption d'index.

--delay-key-write-for-all-tables

Ancienne forme de --delay-key-write=ALL à utiliser sur les versions antérieures à la version 4.0.3. Depuis la version 4.0.3, utilisez --delay-key-write .

--des-key-file=file_name

Lit les clés par défaut utilisées par DES_ENCRYPT() et DES_DECRYPT() dans ce fichier.

--enable-named-pipe

Active le support des pipes nommés (seulement sur NT/Win2000/XP). Cette option ne s'applique qu'aux systèmes Windows NT, 2000 et XP, et peut être utilisé avec les serveurs mysqld-nt et mysqld-max-nt qui supportent les pipes nommés.

--exit-info , -T

Cette option est la combinaison d'options que vous pouvez utiliser pour le débogage du serveur mysqld . Si vous ne savez pas ce que ca fait exactement, ne l'utilisez pas !

--external-locking

Active le verrouillage système. Notez que si vous utilisez cette option sur un système pour qui lockd ne fonctionne pas (comme Linux), vous allez bloquer rapidement mysqld avec les verrous. Anciennement appelée --enable-locking .

Note : si vous utilisez cette option pour activer des modifications de tables MyISAM depuis plusieurs processus MySQL, vous devez vous assurer de trois conditions :

Vous n'utilisez pas de cache de requête pour les requêtes qui utilisent les tables sont modifiées par un autre processus.
Vous ne devez pas utiliser --delay-key-write=ALL ou DELAY_KEY_WRITE=1 sur des tables partagées.

Le plus simple pour s'assurer de cela est de toujours utiliser l'option --external-locking avec --delay-key-write=OFF --query-cache-size=0 .

(Ceci n'est pas fait par défaut, car dans de nombreuses configurations, il est pratique de faire un mélange des options ci-dessus).

--flush

Ecrit toutes les données sur le disque après chaque requête SQL. Normalement, MySQL fait des écritures sur le disque après chaque requête, et laisse le système d'exploitation assurer la synchronisation avec le disque. Que faire si MySQL crashe constamment .

--init-file=file

Lit les commandes SQL dans ce fichier au démarrage. Chaque commande doit être sur une ligne, et ne pas utiliser de commentaires.

--language=lang_name , -L lang_name

Spécifie la langue utilisée pour les messages d'erreur du client. Le chemin complet doit être utilisé. Messages d'erreurs non-anglophones .

--log[=file] , -l [file]

Enregistre les connexions et les requêtes dans ce fichier. Le log général de requêtes . Si vous ne le faites pas, MySQL va utiliser host_name.log comme nom de fichier.

--log-bin=[file]

Enregistre toutes les requêtes qui modifient des données dans un log. Le log binaire des mises à jour . Ce log est utilisé pour la sauvegarde et la réplication. Si vous ne le faites pas, MySQL va utiliser host_name-bin comme nom de fichier.

--log-bin-index[=file]

Fichier d'index pour les noms de fichiers de log binaire. Le log binaire des mises à jour . Si vous ne le faites pas, MySQL va utiliser host_name-bin.index comme nom de fichier.

--log-error[=file]

Enregistre les messages d'erreurs et les messages de démarrage dans ce fichier. Le log d'erreurs . Si vous ne le faites pas, MySQL va utiliser host_name.err comme nom de fichier.

--log-isam[=file]

Enregistre toutes les modifications des tables ISAM / MyISAM dans ce fichier (uniquement nécessaire pour déboguer ISAM / MyISAM ).

--log-long-format

Enregistre des informations supplémentaires dans les fichiers de log (log de modifications, log binaire de modifications, log de requêtes lentes, n'importe quel log en fait). Par exemple, le nom d'utilisateur et un timestamp sont enregistrés avec la requête. Si vous utilisez --log-slow-queries et --log-long-format , alors les requêtes qui n'utilisent pas d'index seront aussi enregistrées. Notez que --log-long-format est obsolète depuis la version 4.1, où --log-short-format a été introduite (le format de log long est la configuration par défaut en version 4.1). Notez aussi que depuis la version MySQL 4.1 l'option --log-queries-not-using-indexes est disponible pour enregistre spécifiquement les requête qui n'utilisent pas d'index, dans le log de requêtes lentes.

--log-queries-not-using-indexes

Si vous utilisez cette option avec --log-slow-queries , alors les requêtes qui n'utilisent pas d'index seront aussi enregistrées dans le log de requêtes lentes. Cette option est disponible depuis MySQL 4.1. Le log des requêtes lentes .

--log-short-format

Enregistre moins d'information dans les fichiers de log (log de modifications, log binaire de modifications, log de requêtes lentes, n'importe quel log en fait). Par exemple, les noms d'utilisateur et un timestamp ne seront pas enregistrés avec les requêtes. Cette option a été ajoutée en MySQL 4.1.

--log-slow-queries[=file]

Enregistre toutes les requêtes qui prennent plus de long_query_time secondes a s'exécuter. Notez que la quantité d'information enregistrée par défaut a changé en MySQL 4.1. Voyez les options --log-long-format et --log-long-format pour plus de détails. Le log des requêtes lentes .

--log-update[=file]

Enregistre les modifications de données dans le fichier file.# où # est un nombre unique, s'il n'est pas fourni. Le log des mises à jour . Le log de modification est obsolète et supprimé en MySQL 5.0.0; vous devriez utiliser le log binaire à la place. ( --log-bin ). Le log binaire des mises à jour . Depuis la version 5.0.0, utilisez --log-update va simplement activer le log binaire. ( Changements de la version5.0.0 (22 Dec 2003: Alpha) ).

--log-warnings , -W

Affiche les alertes comme Aborted connection... dans le fichier d'erreur .err . Activer cette option est recommandé, par exemple, si vous utilisez la réplication : vous obtiendrez plus d'informations sur ce qui se passe, comme les erreurs de connexion réseau, ou les reconnexions. Cette option est activée par défaut depuis MySQL 4.1.2; pour la désactiver, utilisez --skip-log-warnings . Erreurs de communication / connexion annulée .

Cette option s'appelait --warnings avant MySQL 4.0.

--low-priority-updates

Les opérations de modifications de table ( INSERT / DELETE / UPDATE ) auront une priorité inférieure aux sélections. Cela peut être aussi fait via l'attribut {INSERT | REPLACE | UPDATE | DELETE} LOW_PRIORITY ... pour baisser la priorité d'une requête, ou avec SET LOW_PRIORITY_UPDATES=1 pour changer la priorité dans plus d'un thread. Problèmes avec le verrouillage de tables .

--memlock

Verrouille le processus mysqld en mémoire. Cela fonctionne si votre système support la fonction mlockall() (comme Solaris). Ceci peut être utile si vous avez des problèmes avec le système d'exploitation qui force mysqld à utiliser le swap sur le disque.

--myisam-recover [=option[,option...]]]

Cette option est la combinaison de DEFAULT , BACKUP , FORCE et QUICK . Vous pouvez aussi lui donner la valeur explicite de "" si vous voulez désactiver cette option. Si cette option est utilisée, mysqld va vérifier si la table est marquée comme corrompue à l'ouverture de chaque table (cette dernière option ne fonctionne que si vous utilisez l'option --skip-external-locking ). Si c'est le cas, mysqld va essayer de vérifier la table. Si la table était corrompue, mysqld essaie alors de la réparer.L'option suivante va affecter la manière avec la quelle la réparation s'effectue.

Option	Description
DEFAULT	Identique à ne pas donner d'option à --myisam-recover .
BACKUP	Si la table a été modifiée durant la réparation, sauver une copie du fichier table_name.MYD , sous le nom de table_name-datetime.BAK .
FORCE	Exécute une réparation même si nous allons perdre une ou plusieurs lignes dans le fichier .MYD .
QUICK	Ne vérifie pas les lignes dans la table si il n'y a pas eu d'effacement.

Avant que la table ne soit automatiquement réparée, MySQL va ajouter une note dans le fichier de log d'erreurs. Si vous voulez être capable de restaurer la plupart des erreurs sans intervention de l'utilisateur, il vaut utiliser les options BACKUP,FORCE . Cela va forcer la réparation de la table, même si quelques lignes sont effacées, et conserve le vieux fichier de données comme sauvegarde, pour examen ultérieur.

Cette option est disponible depuis MySQL 3.23.25.

--new

Depuis la version 4.0.12, l'option --new sert à dire au serveur d'adopter le comportement de la version 4.1 pour certains aspects, afin de simplifier la migration de 4.0 en 4.1 :

TIMESTAMP est retourné sous forme de chaîne avec le format 'YYYY-MM-DD HH:MM:SS' . Types de colonnes .

Cette option peut vous aider à voir comment vos applications vont se comporter en MySQL 4.1, sans réellement changer de version.

--pid-file=path

Le chemin jusqu'au fichier de PID utilisé par safe_mysqld .

--port=port_num , -P port_num

Numéro de port utilisé pour attendre les connexion TCP/IP.

--old-protocol , -o

Utilise le protocole 3.20, pour la compatibilité avec de très vieux clients. Mise à jour de Version 3.20 vers 3.21 .

--one-thread

Utilise uniquement un thread (pour débogage sous Linux). Cette option est disponible uniquement si le serveur est compilé avec les options de débogage. Déboguer un serveur MySQL .

--open-files-limit=count

Pour changer le nombre de pointeurs de fichiers disponibles pour mysqld . Si cette option n'est pas configurée, ou qu'elle vaut 0, alors mysqld va utiliser cette valeur pour réserver ce nombre de pointeurs de fichiers, à utiliser avec setrlimit() . Si la valeur est 0 alors mysqld va réserver max_connections*5 ou max_connections + table_cache*2 (le plus grand des deux) pointeurs de fichiers. Il est recommandé d'augmenter cette valeur si mysqld émet des erreurs de type 'Too many open files' .

--safe-mode

Ignore certains étapes d'optimisation.

--safe-show-database

Avec cette option, la commande SHOW DATABASES retourne uniquement les bases pour lesquelles l'utilisateur a des droits. Depuis la version 4.0.2, cette option est abandonnée, et ne fait plus rien (l'option est activée par défaut) car nous avons désormais le droit de SHOW DATABASES . Syntaxe de GRANT et REVOKE .

--safe-user-create

Si cette option est activée, un utilisateur ne peut pas créer de nouveaux utilisateurs avec la commande GRANT si l'utilisateur n'a pas les droits de INSERT dans la table mysql.user ou dans aucune colonne de cette table.

--secure-auth

Interdit l'identification des comptes qui ont des mots de passe ancien (avant la version 4.1). Cette option est disponible depuis MySQL 4.1.1.

--skip-bdb

Désactive l'utilisation des tables BDB . Cela va économiser de la mémoire et accélérer le serveur un peu. N'utilisez pas cette option si vous avez besoin des tables BDB .

--skip-concurrent-insert

Désactive la possibilité de sélectionner et insérer en même temps dans les tables MyISAM (cela n'est utile que si vous pensez que vous avez trouvé un bug dans cette fonctionnalité).

--skip-delay-key-write

Ignore l'option DELAY_KEY_WRITE de toutes les tables. Depuis MySQL 4.0.3, vous devez utiliser --delay-key-write=OFF à la place. Choix des paramètres du serveur .

--skip-external-locking

Ne pas utiliser le verrouillage du système. Pour utiliser les utilitaires isamchk ou myisamchk vous devez alors éteindre le système. Degré de stabilité de MySQL . Notez qu'en MySQL version 3.23 vous pouvez utiliser la commande REPAIR et CHECK pour réparer ou vérifier des tables MyISAM tables. Cette option s'appelait auparavant --skip-locking .

--skip-grant-tables

Cette option force le serveur à ne pas utiliser le système de privilège du tout. Cela donne à tous l' accès complet à toutes les bases de données ! Vous pouvez demander à un serveur en exécution d'utiliser à nouveau les tables de droits en exécutant la commande mysqladmin flush-privileges ou mysqladmin reload ).

--skip-host-cache

Ne pas utiliser le cache de nom de domaine pour une résolution des IP plus rapide, mais interroger le serveur DNS à chaque connexion. Comment MySQL utilise les DNS .

--skip-innodb

Désactive l'utilisation des tables InnoDB . Cela va économiser de la mémoire et accélérer le serveur un peu. N'utilisez pas cette option si vous avez besoin des tables InnoDB .

--skip-isam

Désactive l'utilisation des tables ISAM . Cela va économiser de la mémoire et accélérer le serveur un peu. Depuis MySQL 4.1, ISAM est désactivé par défaut, ce qui fait que cette option n'apparaît que si le serveur a été configuré avec le support N'utilisez pas cette option si vous avez besoin des tables ISAM .

--skip-name-resolve

Les noms d'hôtes ne sont pas résolus. Toutes les colonnes Host dans vos tables de droits doivent être des IP numériques ou le mot localhost . Comment MySQL utilise les DNS .

--skip-networking

Ne pas attendre les connexions TCP/IP du tout. Toutes les interactions du serveur mysqld seront faites avec les sockets Unix. Cette option est particulièrement recommandée pour les systèmes qui utilisent des requêtes locales. Comment MySQL utilise les DNS .

--skip-new

Ne pas utiliser les nouvelles routines qui sont possiblement erronées.

--skip-symlink

C'est l'ancienne forme de --skip-symbolic-links , à utiliser avant MySQL 4.0.13.

--symbolic-links , --skip-symbolic-links

Active ou désactive le support des liens symboliques. Cette option a différents effets sur Windows et sur Unix.

Sous Windows, activer les liens symboliques vous permet d'établir un lien symbolique vers une base de données, en créant un fichier directory.sym qui contient le chemin réel. Utiliser les liens symboliques pour les bases sous Windows .
Sous Unix, activer les liens symboliques signifie que vous pouvez mettre un fichier d'index MyISAM ou un autre fichier de données dans un autre dossier, avec les options INDEX DIRECTORY ou DATA DIRECTORY de la commande CREATE TABLE . Si vous effacer ou renommez la table, les fichiers qui sont des liens symboliques seront aussi effacés ou renommés. Syntaxe de CREATE TABLE .

Cette option est disponible depuis MySQL 4.0.13.

--skip-show-database

Si MySQL est configuré avec --with-debug=full , tous les programmes vérifieront la mémoire pour rechercher les écrasements de zone lors des allocations et libérations de mémoire. Comme ce test est lent, vous pouvez l'éviter, si vous n'avez pas besoin de tester la mémoire, en utilisant cette option.

--skip-show-database

Ne pas autoriser la commande SHOW DATABASES , a moins que l'utilisateur n'ait les droits de SHOW DATABASES . Depuis la version 4.0.2, vous n'avez plus besoin de cette option, car les droits pour ce faire sont distribués avec le droit de SHOW DATABASES .

--skip-stack-trace

Ne pas écrire les piles de traces. Cette option est pratique lorsque vous utilisez mysqld avec un débogueur. Sur certains systèmes, vous devez aussi utiliser cette option pour obtenir un fichier de core. Déboguer un serveur MySQL .

--skip-thread-priority

Désactive les priorités des threads pour améliorer la vitesse de réponse.

--socket=path

Sous Unix, le fichier de socket pour les connexions locales. (par défaut, /tmp/mysql.sock ). Sous Windows, le nom du pipe à utiliser pour les connexions locales qui utilisent un pipe nommé (par défaut, MySQL ).

--sql-mode=value[,value[,value...]]

Spécifie le mode SQL. Le mode SQL du serveur . Cette option est disponible depuis 3.23.41.

--temp-pool

En utilisant cette option, vous allez réduire le jeu de noms qui sont utilisés lors de la création de fichier temporaires, plutôt qu'un nom unique à chaque fois. Ceci est un palliatif au noyau Linux qui crée plusieurs fichiers nouveaux avec des noms différents. Avec l'ancien comportement, Linux semble "perdre de la mémoire", car ils sont alloués au cache d'entrées du dossier au lieu de celui du disque.

--transaction-isolation=level

Configure le niveau d'isolation des transactions. Le niveau peut être READ-UNCOMMITTED , READ-COMMITTED , REPEATABLE-READ ou SERIALIZABLE . Syntaxe de SET TRANSACTION .

--tmpdir=path , -t path

Chemin vers les fichiers temporaires. Il peut s'avérer pratique si votre dossier par défaut /tmp réside dans une partition qui est trop petite pour absorber les tables temporaires. Depuis MySQL MySQL 4.1, cette option accepte différents chemins, qui sont utilisés en alternance. Les chemins doivent être séparés par des deux points ( ':' ) sous Unix et des points-virgules ( ';' ) sous Windows. Il est possible de dire à tmpdir de pointer sur un système de fichiers en mémoire, hormis si le serveur MySQL est un esclave. Si c'est un esclave, il faut un système de fichiers permanents (pour que la réplication des tables temporaires et des commandes LOAD DATA INFILE ) survive a un redémarrage de la machine : un système de fichiers en mémoire tmpdir , qui est effacé au lancement de la machine n'est pas acceptable. Un disque est nécessaire pour tmpdir , dans ce contexte.

--user={user_name | user_id} , -u {user_name | user_id}

Exécute le démon mysqld avec l'utilisateur user_name ou userid (numérique). (``utilisateur'' dans ce contexte fait référence à l'utilisateur du système d'exploitation, mais pas l'utilisateur MySQL, listé dans les tables de droits.)Cette option est obligatoire lorsque vous démarrez mysqld en tant que root . Le serveur va changer d'ID durant le lancement du serveur, pour utiliser un autre utilisateur que root . Problèmes généraux de sécurité .

Depuis MySQL 3.23.56 et 4.0.12: Pour éviter des trous de sécurité si un utilisateur ajoute --user=root dans un fichier my.cnf (et donc, faisant que le serveur fonctionne en tant que utilisateur système root ), mysqld utilise uniquement la première option --user spécifiée, et produit une alerte s'il rencontre d'autres options --user . Les options des fichiers /etc/my.cnf et datadir/my.cnf sont traités avant les options de ligne de commande, et il est recommandé que vous ajoutiez l'option --user dans le fichier /etc/my.cnf puis spécifiez une valeur autre que root . L'option de /etc/my.cnf peut être placée avant toute autre option --user , ce qui assure que le serveur fonctionnera avec l'utilisateur autre que root , et qu'une alerte apparaîtra si une autre option --user est découverte.

--version , -V

Affiche les informations de version.

Il est aussi possible de donner des valeurs aux variables avec la syntaxe --set-variable=var_name=value ou -O var_name=value . Notez que cette syntaxe est abandonnée depuis MySQL 4.0.

Vous pouvez changer la valeur de la plupart des variables système sur un serveur en fonctionnement avec la commande SET . Syntaxe de SET .