Curso de MariaDB / Conferir configuração do servidor, modos SQL, fusos e logs
Para examinar a configuração do MariaDB, diferencie os arquivos de opções, os valores globais atuais e os valores da sessão conectada. Modos SQL e fusos horários podem variar entre conexões; o log de erros e o de consultas lentas respondem a perguntas diferentes e têm condições de registro distintas.
Diferenciar arquivo, GLOBAL e SESSION
| Escopo | Significado | O que conferir |
|---|---|---|
| Arquivo de opções | Opções lidas na inicialização do servidor ou cliente | Arquivos efetivos, grupos, ordem de leitura e argumentos do serviço |
| GLOBAL | Valor do servidor ou padrão para novas conexões | Mudanças dinâmicas e permissões necessárias conforme a variável |
| SESSION | Valor da conexão atual | Outra conexão pode diferir; o valor termina com a sessão |
Alterar um padrão global não atualiza necessariamente as sessões existentes. Uma mudança de sessão também não demonstra o que sobreviverá à reinicialização. Comece pelas consultas de leitura abaixo. Os exemplos executáveis foram verificados com MariaDB 12.3.3; os nomes das opções de log lento do arquivo correspondem ao MariaDB 10.11 e posteriores.
O tutorial de eventos agendados mostra por que o contexto de horário importa. Para diagnosticar consultas, o tutorial de EXPLAIN e comparação de planos diferencia estimativas de observações da execução real.
SELECT VERSION(), @@GLOBAL.sql_mode, @@SESSION.sql_mode,
@@GLOBAL.time_zone, @@SESSION.time_zone, @@system_time_zone;
SHOW GLOBAL VARIABLES WHERE Variable_name IN
('datadir', 'log_error', 'log_output', 'log_slow_query',
'log_slow_query_file', 'log_slow_query_time');
As permissões ou a política de um serviço gerenciado podem limitar as informações disponíveis. Examine a versão e as variáveis do servidor ao qual está conectado. A referência de variáveis do sistema MariaDB indica o escopo e a possibilidade de modificar cada variável dinamicamente.
Localizar os arquivos que o serviço realmente lê
Sistemas do tipo Unix costumam usar my.cnf; Windows pode usar my.ini ou my.cnf. Os locais específicos dependem da instalação e dos argumentos de inicialização do serviço. O comando abaixo indica os caminhos padrão e os grupos de opções do executável; use seu caminho completo se não estiver disponível em PATH.
mariadbd --help --verbose
Leia as seções de arquivos e grupos de opções e confira se o serviço fornece um --defaults-file específico. Um arquivo lido depois pode substituir um valor anterior. A saída pode conter valores sensíveis, portanto evite compartilhá-la inteira. As regras oficiais dos arquivos de opções descrevem a leitura.
Em um servidor dedicado a estudos, as opções seguintes permitem observar uma configuração persistente. Copie primeiro o arquivo realmente lido e anote as linhas alteradas. Aplique-as ao grupo [mariadbd] correspondente; os nomes dentro do arquivo não levam o prefixo de linha de comando --.
[mariadbd]
sql-mode=STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
default-time-zone=+00:00
log-output=FILE
log-slow-query=ON
log-slow-query-time=1
log-slow-query-file=appops-slow.log
O nome do log lento é relativo: depois consulte o diretório de dados e o caminho efetivo. Reinicie somente o servidor isolado pelo gerenciador de serviços do Windows ou pelo procedimento Linux habitual dessa instalação. Se não iniciar, examine o log de erros e restaure o arquivo copiado. O exercício não exige reiniciar um servidor de produção compartilhado.
Alterar um modo SQL na sessão atual
Crie a tabela descartável no banco de estudos appops_lab. Se o banco já existir, confirme seu uso; se mode_items existir, examine sua definição e seus dados antes de repetir CREATE.
CREATE DATABASE IF NOT EXISTS appops_lab
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE appops_lab;
CREATE TABLE mode_items (
item_id INT PRIMARY KEY, category_name VARCHAR(20), price INT
) ENGINE=InnoDB;
INSERT INTO mode_items VALUES (1, 'Books', 10), (2, 'Books', 20), (3, 'Tools', 30);
Na mesma conexão, preserve os modos atuais e acrescente ONLY_FULL_GROUP_BY, sem esvaziar toda a lista:
SET @saved_mode = @@SESSION.sql_mode;
SET SESSION sql_mode = CONCAT_WS(',', NULLIF(@saved_mode, ''), 'ONLY_FULL_GROUP_BY');
SELECT category_name, SUM(price) AS total FROM mode_items GROUP BY category_name;
A agregação válida retorna Books, livros, com total 30 e Tools, ferramentas, com total 30. A ordem das duas linhas não é garantida, pois não existe ORDER BY. Execute separadamente a consulta seguinte:
SELECT category_name, price FROM mode_items GROUP BY category_name;
ONLY_FULL_GROUP_BY rejeita price sem agregação, que não faz parte das colunas de agrupamento. Depois do erro esperado, execute explicitamente as instruções de restauração:
SET SESSION sql_mode = @saved_mode;
SELECT @@SESSION.sql_mode;
Em vez de remover todos os modos para permitir um preço arbitrário por grupo, determine o resultado necessário e corrija a agregação ou o agrupamento. Programas armazenados também preservam modos relevantes de sua criação: o valor de um arquivo não explica sozinho todo seu comportamento. A referência SQL_MODE descreve essas condições.
Comparar TIMESTAMP e DATETIME entre fusos horários
Mantenha o mesmo banco e a mesma conexão. zone_example deve ser uma tabela nova de estudos; examine qualquer objeto existente com esse nome antes de continuar.
SET @saved_time_zone = @@SESSION.time_zone;
SET SESSION time_zone = '+09:00';
CREATE TABLE zone_example (id INT PRIMARY KEY, ts TIMESTAMP, dt DATETIME);
INSERT INTO zone_example VALUES (1, '2026-01-01 09:00:00', '2026-01-01 09:00:00');
SELECT ts, dt FROM zone_example;
SET SESSION time_zone = '+00:00';
SELECT ts, dt FROM zone_example;
SET SESSION time_zone = @saved_time_zone;
O primeiro SELECT mostra 2026-01-01 09:00:00 nas duas colunas. Ao mudar para +00:00, TIMESTAMP mostra 2026-01-01 00:00:00, enquanto DATETIME conserva 09:00:00. Isso diferencia a conversão de TIMESTAMP conforme o fuso da sessão dos campos de data e hora de DATETIME. A última instrução restaura o fuso original.
Fusos nomeados, como Asia/Seoul, dependem das tabelas de fusos horários do servidor. Se um nome não for reconhecido, confira sua instalação e atualização. Um deslocamento numérico fixo e um fuso geográfico não seguem necessariamente as mesmas regras de horário de verão. Estabeleça também uma política coerente de armazenamento e apresentação na aplicação; as descrições de time_zone e system_time_zone na referência de variáveis diferenciam seus escopos.
Ler o log que responde à pergunta
| Log | Uso | O que conferir |
|---|---|---|
| Erros | Inicialização, encerramento, erros e avisos do servidor | log_error e destino do serviço ou contêiner |
| Consultas lentas | Diagnóstico de consultas que atendem às condições configuradas | Ativação, limite, saída, filtros e mínimo de linhas examinadas |
| Consultas gerais | Registro amplo de conexões e consultas | Custo e exposição de dados sensíveis; não presuma que precisa estar sempre ativo |
Um log lento ativo não registra toda consulta que um usuário considera lenta. Confira o limite e os filtros e diferencie o padrão global do valor da sessão. Verifique se a saída é FILE ou TABLE. Como SQL pode conter dados pessoais, gerencie acesso, rotação e retenção. A introdução ao log de consultas lentas explica as condições de registro e os nomes de variáveis renomeados.
Em uma sessão nova do servidor isolado, com limite de um segundo e filtros permissivos, SELECT SLEEP(1.2); pode ajudar a verificar o destino do log. A consulta espera deliberadamente em vez de tornar lento um trabalho do negócio. Se não aparecer uma entrada, confira ativação, destino e filtros antes de aumentar repetidamente a espera.
Restaurar os ajustes e confirmar o resultado
- Anote os valores de sessão e globais e identifique conexões e tarefas afetadas.
- Altere uma única condição da sessão e observe seu efeito.
- Somente se precisar de persistência, copie o arquivo de opções e modifique a opção adequada.
- Siga o procedimento de reinicialização do administrador e consulte os valores efetivos por uma conexão nova.
- Se necessário, restaure os valores anotados ou o arquivo copiado e confira o log de erros e o comportamento esperado.
Para remover somente as tabelas descartáveis, use DROP TABLE appops_lab.mode_items, appops_lab.zone_example; depois de confirmar os nomes e que não precisa mais dos dados. Restaurar um arquivo, restabelecer valores da sessão e remover tabelas são ações distintas: DROP TABLE não retorna a configuração do servidor ao estado inicial. Um ROLLBACK comum também não recupera as tabelas removidas.




