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

  1. Anote os valores de sessão e globais e identifique conexões e tarefas afetadas.
  2. Altere uma única condição da sessão e observe seu efeito.
  3. Somente se precisar de persistência, copie o arquivo de opções e modifique a opção adequada.
  4. Siga o procedimento de reinicialização do administrador e consulte os valores efetivos por uma conexão nova.
  5. 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.