Tanto o serviço do MySQL (mysqld) quanto seus clientes de linha de comando (mysql, mysqladmin, etc), podem ser configurados/parametrizados basicamente de três maneiras diferentes:
- Variáveis de ambiente
- Arquivo de configurações
- Linha de comando
Lembrando que há uma ordem de precedência envolvida ao usar as opções de configuração. Ou seja, se uma determinada opção foi especificada em uma variável de ambiente e também pela linha de comando, o valor da linha de comando será usada pois é a última forma a ser inspecionada (maior precedência).
NOTA: Há uma exceção nessa ordem de precedência. O servidor MySQL (mysqld), irá processar por último o arquivo mysqld-auto.cnf, se este existir dentro do diretório de dados (datadir). Ele tem maior precedência até mesmo sobre as opções de linha de comando.
Neste link é possível encontrar a lista das variáveis de ambiente disponíveis para utilização e que alteram as configurações do MySQL.
[opc@orl8 mysql]$ export MYSQL_PS1='servidor-1 >> '
[opc@orl8 mysql]$ bin/mysql -u root -p
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 13
Server version: 8.0.36 MySQL Community Server - GPL
Copyright (c) 2000, 2024, Oracle and/or its affiliates.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
servidor-1 >>
Por padrão, as opções de configuração são lidas através dos seguintes arquivos nesta ordem:
- /etc/my.cnf
- /etc/mysql/my.cnf
- /usr/local/mysql/etc/my.cnf
- ~/.my.cnf
Em uma instalação a partir dos binários prontos para download, eu particularmente prefiro utilizar o diretório "/etc/mysql" para incluír todos os arquivos de configuração do MySQL. Neste caso, o MySQL irá procurar pelo arquivo "my.cnf" dentro do diretório "/etc/mysql":
[root@orl8 mysql]# cat /etc/mysql/my.cnf
[mysqld]
basedir = /usr/local/mysql
datadir = /usr/local/mysql/data
socket = /tmp/mysql.sock
[mysql]
default-character-set = latin1
O arquivo de configurações é divido em diferentes seções que também são chamados de grupos ou cabeçalhos. Cada seção representa diretamente um programa do MySQL no qual é possível definir opções e valores.
Vimos em "Iniciar e parar o serviço do MySQL", que é possível iniciar o serviço do MySQL diretamente pelo binário mysqld ou pelo script mysqld_safe. Cada modo de inicialização lê as suas configuraçõesas de diferentes seções:
-
Para o binário mysqld, as suas configurações são lidas de qualquer uma das seções: [mysqld], [mysql_cluster], [server] ou [mysqld-8.0]
-
Já para o script mysqld_safe, as suas configurações são lidas de qualquer uma das seções: [mysqld], [server], [mysqld_safe] ou [safe_mysqld]
Independente da forma que se inicializa, há diversos parâmetros que configuram o modo de operação do serviço MySQL. Para se obter a lista das opções disponíveis e seus valores, usa-se o comando abaixo:
[root@orl8 mysql]# bin/mysqld --verbose --help
...
tls-ciphersuites (No default value)
tls-version TLSv1.2,TLSv1.3
tmp-table-size 16777216
tmpdir /tmp
transaction-alloc-block-size 8192
transaction-isolation REPEATABLE-READ
transaction-prealloc-size 4096
transaction-read-only FALSE
...
NOTA: É possível utilizar o conjunto de opções --verbose e --help em qualquer comando do MySQL para obter a lista das opções disponíveis.
Estas opções podem ser transportadas para dentro do arquivo de configurações com seu valor modificado, se for o caso:
Após reiniciar o serviço, é possível verificar o novo valor definido para o parâmetro "tmpdir":
[root@orl8 mysql]# bin/mysqld --verbose --help
...
tls-ciphersuites (No default value)
tls-version TLSv1.2,TLSv1.3
tmp-table-size 16777216
tmpdir /var/tmp
transaction-alloc-block-size 8192
transaction-isolation REPEATABLE-READ
transaction-prealloc-size 4096
transaction-read-only FALSE
...
Uma outra forma para se verificar esses valores é a partir do cliente de linha de comando mysql, através da instrução abaixo:
mysql> SHOW VARIABLES \G
Ou, pelo mysqladmin:
[root@orl8 mysql]# bin/mysqladmin -p variables
Após qualquer alteração no arquivo de configurações, é importante validar seu conteúdo com o comando abaixo:
[root@orl8 mysql]# bin/mysqld --validate-config
Será exibido um erro caso o arquivo tenha qualquer opção ou valor inválido:
[root@orl8 mysql]# bin/mysqld --validate-config
2024-02-05T12:26:16.910193Z 0 [ERROR] [MY-000067] [Server] unknown variable 'diretorio_tmp=/var/tmp'.
2024-02-05T12:26:16.910225Z 0 [ERROR] [MY-010119] [Server] Aborting
É possível validar um arquivo de configuração que encontra-se em um local fora do padrão:
[root@orl8 mysql]# bin/mysqld --defaults-file=/opt/mysql/my.cnf --validate-config
NOTA: A opção --validade-config é particularmente útil quando se atualiza a versão do MySQL pois ela dirá, caso uma opção tenha sido removida na versão atualizada.
O grupo de opções [client] permite especificar as opções que serão aplicadas para todos os programas cliente do MySQL, e não pelo mysqld.
[client]
port=3306
socket=/tmp/mysql.sock
[mysqld]
port=3306
socket=/tmp/mysql.sock
key_buffer_size=16M
max_allowed_packet=128M
[mysqldump]
quick
Os programas que fazem parte da instalação do MySQL podem ser configurados através de inumeras opções informadas pela linha de comando. Tais opções são processadas na ordem em que são especificadas. Caso uma mesma opção seja especificada múltiplas vezes, a última ocorrência prevalecerá.
Por exemplo, o comando abaixo faz com que o cliente mysql se conecte ao localhost e não ao host db.armbrust.eti.br:
[root@orl8 mysql]# bin/mysql -u root -p -h db.armbrust.eti.br -h localhost
NOTA: Existe uma exceção a essa regra para o binário mysqld que irá processar somente a primeira ocorrência da opção --user por questões de segurança.
As opções de linha de comando são case-sensitive e muitas delas, podem ser especificadas usando a sua forma curta, pelo uso de apenas um traço (ex: -h). Ou a forma longa, que utiliza dois traços (ex: --help). Ambas as formas geram o mesmo resultado.
Ao usar uma opção em sua forma longa e que requer um valor, deve-se utilizar o sinal de igual entre a opção e seu valor (ex: --host=localhost). O sinal de igual não é necessário ao utilizar a sua forma curta (ex: -h localhost).
Uma dica final. Quando se utiliza a opção -p para especificar uma senha, nunca utilize um espaço entre a opção e seu valor:
[root@orl8 mysql]# bin/mysql -u root -h localhost -pSup3rS3cr3t0!
O programa de linha de comando irá interpretar o espaço como parte da senha:
[opc@orl8 mysql]$ bin/mysql -u root -h localhost -p Sup3rS3cr3t0!
Enter password:
ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: NO)