4.9 MySQL Program Environment Variables

Table des matières

This section lists environment variables that are used directly or indirectly by MySQL. Most of these can also be found in other places in this manual.

Options on the command line take precedence over values specified in option files and environment variables, and values in option files take precedence over values in environment variables. In many cases, it is preferable to use an option file instead of environment variables to modify the behavior of MySQL. See Section 4.2.7, “Using Option Files”.

Variable	Description
`AUTHENTICATION_PAM_LOG`	PAM authentication plugin debug logging settings.
`CC`	The name of your C compiler (for running CMake).
`CXX`	The name of your C++ compiler (for running CMake).
`CC`	The name of your C compiler (for running CMake).
`DBI_USER`	The default user name for Perl DBI.
`DBI_TRACE`	Trace options for Perl DBI.
`HOME`	The default path for the mysql history file is `$HOME/.mysql_history`.
`LD_RUN_PATH`	Used to specify the location of `libmysqlclient.so`.
`LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN`	Enable `mysql_clear_password` authentication plugin; see Section 6.5.1.4, “Client-Side Cleartext Pluggable Authentication”.
`LIBMYSQL_PLUGIN_DIR`	Directory in which to look for client plugins.
`LIBMYSQL_PLUGINS`	Client plugins to preload.
`MYSQL_DEBUG`	Debug trace options when debugging.
`MYSQL_GROUP_SUFFIX`	Option group suffix value (like specifying `--defaults-group-suffix`).
`MYSQL_HISTFILE`	The path to the mysql history file. If this variable is set, its value overrides the default for `$HOME/.mysql_history`.
`MYSQL_HISTIGNORE`	Patterns specifying statements that mysql should not log to `$HOME/.mysql_history`, or `syslog` if `--syslog` is given.
`MYSQL_HOME`	The path to the directory in which the server-specific `my.cnf` file resides.
`MYSQL_HOST`	The default host name used by the mysql command-line client.
`MYSQL_OPENSSL_UDF_DH_BITS_THRESHOLD`	Maximum key length for `CREATE_DH_PARAMETERS()`. See Section 12.19.2, “MySQL Enterprise Encryption Usage and Examples”.
`MYSQL_OPENSSL_UDF_DSA_BITS_THRESHOLD`	Maximum DSA key length for `CREATE_ASYMMETRIC_PRIV_KEY()`. See Section 12.19.2, “MySQL Enterprise Encryption Usage and Examples”.
`MYSQL_OPENSSL_UDF_RSA_BITS_THRESHOLD`	Maximum RSA key length for `CREATE_ASYMMETRIC_PRIV_KEY()`. See Section 12.19.2, “MySQL Enterprise Encryption Usage and Examples”.
`MYSQL_PS1`	The command prompt to use in the mysql command-line client.
`MYSQL_PWD`	The default password when connecting to mysqld. Using this is insecure. See Section 6.1.2.1, “End-User Guidelines for Password Security”.
`MYSQL_TCP_PORT`	The default TCP/IP port number.
`MYSQL_TEST_LOGIN_FILE`	The name of the `.mylogin.cnf` login path file.
`MYSQL_TEST_TRACE_CRASH`	Whether the test protocol trace plugin crashes clients. See note following table.
`MYSQL_TEST_TRACE_DEBUG`	Whether the test protocol trace plugin produces output. See note following table.
`MYSQL_UNIX_PORT`	The default Unix socket file name; used for connections to `localhost`.
`MYSQLX_TCP_PORT`	The X Plugin default TCP/IP port number.
`MYSQLX_UNIX_PORT`	The X Plugin default Unix socket file name; used for connections to `localhost`.
`NOTIFY_SOCKET`	Socket used by mysqld to communicate with systemd.
`PATH`	Used by the shell to find MySQL programs.
`PKG_CONFIG_PATH`	Location of `mysqlclient.pc` pkg-config file. See note following table.
`TMPDIR`	The directory in which temporary files are created.
`TZ`	This should be set to your local time zone. See Section B.6.3.7, “Time Zone Problems”.
`UMASK`	The user-file creation mode when creating files. See note following table.
`UMASK_DIR`	The user-directory creation mode when creating directories. See note following table.
`USER`	The default user name on Windows when connecting to mysqld.

For information about the mysql history file, see Section 4.5.1.3, “mysql Client Logging”.

MYSQL_TEST_LOGIN_FILE is the path name of the login path file (the file created by mysql_config_editor). If not set, the default value is %APPDATA%\MySQL\.mylogin.cnf directory on Windows and $HOME/.mylogin.cnf on non-Windows systems. See Section 4.6.7, “mysql_config_editor — MySQL Configuration Utility”.

The MYSQL_TEST_TRACE_DEBUG and MYSQL_TEST_TRACE_CRASH variables control the test protocol trace client plugin, if MySQL is built with that plugin enabled. For more information, see Section 29.2.4.11.1, “Using the Test Protocol Trace Plugin”.

The default UMASK and UMASK_DIR values are 0640 and 0750, respectively. MySQL assumes that the value for UMASK or UMASK_DIR is in octal if it starts with a zero. For example, setting UMASK=0600 is equivalent to UMASK=384 because 0600 octal is 384 decimal.

The UMASK and UMASK_DIR variables, despite their names, are used as modes, not masks:

If UMASK is set, mysqld uses ($UMASK | 0600) as the mode for file creation, so that newly created files have a mode in the range from 0600 to 0666 (all values octal).
If UMASK_DIR is set, mysqld uses ($UMASK_DIR | 0700) as the base mode for directory creation, which then is AND-ed with ~(~$UMASK & 0666), so that newly created directories have a mode in the range from 0700 to 0777 (all values octal). The AND operation may remove read and write permissions from the directory mode, but not execute permissions.

It may be necessary to set PKG_CONFIG_PATH if you use pkg-config for building MySQL programs. See Section 28.7.4.2, “Building C API Client Programs Using pkg-config”.

Rechercher dans le manuel MySQL

Traduction non disponible

Le manuel MySQL n'est pas encore traduit en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Document créé le 26/06/2006, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/mysql-rf-environment-variables.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel MySQL : https://dev.mysql.com/

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut