MariaDB 教程 / 检查配置、SQL 模式、时区与日志
检查 MariaDB 配置时,应区分选项文件、全局运行值与当前连接的会话值。SQL 模式和时区可能因连接而异;错误日志和慢查询日志也回答不同问题,必须核对其输出位置与记录条件。
区分文件、GLOBAL 与 SESSION 三种范围
| 范围 | 含义 | 需要区分 |
|---|---|---|
| 选项文件 | 服务器或客户端启动时读取的选项 | 真实文件、选项组、读取顺序与服务启动参数 |
| GLOBAL | 服务器全局值,或新连接的默认值 | 是否支持动态修改、所需权限与既有会话的影响 |
| SESSION | 当前连接使用的值 | 其他连接可能不同,连接结束后该会话值消失 |
修改全局默认值不一定更新已有会话,只改 SESSION 也不能证明重启后仍保留。先使用只读查询检查实际值。本篇可执行例子的验证环境为 MariaDB 12.3.3,配置中的慢日志选项名称适用于 10.11 及以后版本;其他版本应查对应变量。
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');
权限或托管服务政策可能限制能看到的信息,应依据真实版本和变量名判断。系统变量参考说明了范围与动态修改条件。还可结合DATE、DATETIME、TIMESTAMP 的区别、事件预约的时区和EXPLAIN 执行计划定位具体问题。
找到服务实际读取的选项文件
类 Unix 系统常用 my.cnf,Windows 可使用 my.ini 或 my.cnf,路径取决于安装和服务参数。在操作系统终端运行以下命令查看该二进制文件的默认路径与选项组;如不在 PATH,使用实际可执行文件完整路径。
mariadbd --help --verbose
阅读默认文件与选项组部分,再检查服务是否指定独立的 --defaults-file。后读取的文件或其他启动参数可能覆盖之前的值;完整输出可能包含敏感选项,不要直接公开。参见官方选项文件规则。
仅在专用学习服务器,先备份真实配置文件、记录改动行,再在实际使用的 [mariadbd] 组内设置以下示例。选项文件名称不带命令行的双连字符前缀。
[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
日志文件名使用相对路径,重启后还要查询实际 datadir 和生成路径。按该学习实例的 Windows 服务管理或 Linux 服务流程重启;若启动失败,查看错误日志并恢复备份文件。共享生产服务器重启不属于本练习范围。
只改变当前会话的一个 SQL 模式条件
先检查 appops_lab 的归属以及 mode_items 是否已被使用,已有对象须检查定义与数据,不直接覆盖。以下 SQL 在 MariaDB 客户端建立独立样本:
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);
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;
正确聚合应返回 Books 的金额 30 与 Tools 的金额 30。下一条单独执行,ONLY_FULL_GROUP_BY 应拒绝未被分组或聚合的 price。观察预期错误后,仍须主动执行恢复语句,不要因报错就跳过恢复。
SELECT category_name, price FROM mode_items GROUP BY category_name;
SET SESSION sql_mode = @saved_mode;
SELECT @@SESSION.sql_mode;
若想获得每类的某个价格,应先明确所需规则,再修改聚合或分组;不要清空整个 SQL 模式列表来允许任意取一行。存储程序还会保留相关创建时 SQL 模式,不能只凭当前配置文件解释全部例程行为;参见 SQL_MODE 文档。
切换时区,比较 TIMESTAMP 与 DATETIME
先确认 zone_example 名称未被使用,以下完整示例保存当前时区、写入固定时间、切换后比较,再恢复原值:
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;
第一次查询两列均为 2026-01-01 09:00:00。切换到 +00:00 后,TIMESTAMP 显示 2026-01-01 00:00:00,DATETIME 仍为 09:00:00。差异来自 TIMESTAMP 的会话时区转换,而 DATETIME 保存日期与时间字段,并不在本实验中按会话时区改变显示值。
最后一句恢复原会话时区。Asia/Seoul 等命名时区依赖服务器时区表;未知名称时检查时区数据安装与更新,不要把固定数字偏移与地理时区的夏令时行为当作普遍等价。应用还应规定一致的存储、传输与显示政策。
根据要解决的问题选择日志
| 日志 | 主要用途 | 检查内容 |
|---|---|---|
| 错误日志 | 启动、停止、服务器错误与警告 | log_error、服务或容器的实际日志目标 |
| 慢查询日志 | 记录满足条件的查询以诊断耗时 | 启用状态、阈值、输出、过滤器与最少扫描行数 |
| 通用查询日志 | 较广泛地记录连接和查询 | 性能、敏感语句暴露,不应默认长期全量启用 |
启用慢查询日志不表示记录所有用户认为慢的语句。检查阈值和过滤条件,区分当前会话值与新的全局默认值,并确认输出是 FILE 还是 TABLE。SQL 可能包含个人资料或其他敏感内容,需要管理日志访问、轮换和保存期限。慢查询日志概述说明了记录条件与重命名变量。
在新连接的隔离学习会话中,若阈值为一秒且过滤条件允许,SELECT SLEEP(1.2); 可用于确认实际记录目标。它有意等待,避免给业务负载制造耗时。如果没有记录,先检查启用状态、目标、过滤器与最少扫描行数,再决定后续操作,不要不断增加等待时间。
恢复设置后再次核对实际结果
- 记录 SESSION 与 GLOBAL 值,明确可能影响的连接与任务。
- 一次改变一个会话条件,比较预期行为并恢复原值。
- 确需跨重启保留时,备份选项文件并只修改相关项。
- 按管理员流程重启,通过新连接查询实际生效值。
- 需要回退时恢复原值或备份文件,再检查错误日志与业务行为。
练习表确认可丢弃后,备份要保留的数据,执行 DROP TABLE appops_lab.mode_items, appops_lab.zone_example;。恢复配置文件、恢复会话设置与删除练习表是不同操作;删表不会重置服务器配置,普通 ROLLBACK 也不能撤销删表。




