4.3. Especificar opciones de programa

Los espacios en blanco sobrantes son automáticamente eliminados de los nombres de opciones y valores. se pueden utilizar las secuencias de escape '\b', '\t', '\n', '\r', '\\', y '\s' al especificar el valor de una opción si es necesario representar los caracteres backspace, tab, salto de linea, retorno de carro y espacio.

En Windows, si el valor de una opción representa una ruta a un directorio o un fichero, se debería especificar el valor utilizando '/' en lugar '\' como separador. Si se emplea '\', debe duplicarse y poner '\\', puesto que '\' es el caracter de escape en MySQL.

Si el nombre de un grupo es igual que el de un programa, las opciones en el grupo se aplicarán específicamente a ese programa.

El grupo de opciones [client] es leido por todos los programas clientes (pero no por mysqld). Esto permite especificar opciones aplicables a todos los clientes. Por ejemplo, [client] es el grupo perfecto para indicar la contraseña que se utiliza para conectarse al server. (Pero es necesario asegurarse que el fichero de opciones es accesible para lectura y escritura solamente por Usted, de modo que otras personas no puedan conocer la contraseña). Una opción no debe colocarse en el grupo [client] a menos que sea reconocida por todos los programas cliente que se utilizan. Los programas que no la soporten terminarán después de mostrar un mensaje de error si se los intenta ejecutar.

A partir de MySQL 5.0.4 en la serie 5.0, es posible emplear directivas !include en los ficheros de opciones para incluir ficheros específicos y !includedir para incluir directorios Por ejemplo, para incluir el fichero /home/mydir/myopt.cnf, se puede usar lo siguiente:

!include /home/me/myopt.cnf

Para buscar en el directorio /home/mydir todos los ficheros con extensión .cnf y leerlos como ficheros de opciones, se debería utilizar:

!includedir /home/mydir

Observe que estas opciones son específicas de cada sección. Por ejemplo, suponga que fuera a utilizar en my.cnf algo como lo siguiente:

[mysqld]
!include /home/mydir/myopt.cnf

En ese caso, el fichero myopt.cnf sólo sería procesado por el servidor, y la directiva !include sería ignorada por cualquier aplicación cliente. Sin embargo, si empleara:

[mysqldump]
!includedir /home/mydir/my-dump-options

entonces el directorio /home/mydir/my-dump-options sería verificado en busca de ficheros de opciones con extensión .cnf únicamente por mysqldump y no por el servidor o por otras aplicaciones cliente.

Nota: En la actualidad, cualquier fichero que deba ser encontrado e incluido al usar la directiva !includedir debe tener en su nombre la extensión .cnf. En Windows, esta directiva también verifica en busca de ficheros con extensión .ini.

En la versión 4.0.14 de MySQL y posteriores, si se desea crear un grupo de opciones que deba ser leido únicamente por una versión específica de mysqld, se puede hacer dando a los grupos de opciones nombres como los siguientes: [mysqld-4.0], [mysqld-4.1], [mysqld-5.0], y así sucesivamente. El siguiente grupo indica que la opción --new debería ser aplicada sólo por servidores de bases de datos MySQL versión 5.0.x:

[mysqld-5.0]
new

Aquí hay un fichero de opciones globales típico:

[client]
port=3306
socket=/tmp/mysql.sock

[mysqld]
port=3306
socket=/tmp/mysql.sock
key_buffer_size=16M
max_allowed_packet=8M

[mysqldump]
quick

El fichero de opciones anterior utiliza la sintaxis var_name=value para las líneas que establecen los valores de las variables key_buffer_size y max_allowed_packet.

[client]
# El siguiente password se enviará a todos los clientes MySQL estándar
password="my_password"

[mysql]
no-auto-rehash
connect_timeout=2

[mysqlhotcopy]
interactive-timeout

shell> my_print_defaults client mysql
--port=3306
--socket=/tmp/mysql.sock
--no-auto-rehash