# =============================================================================
# XINFRA MySQL 实例配置文件（Jinja2 模板）
# =============================================================================
# 此文件由 Playbook 自动生成，禁止手动编辑
# 修改配置请通过平台参数传递，重新部署即可
# =============================================================================

# 客户端连接配置（mysql 命令行工具使用）
[client]
socket={{ mysql_run_dir }}/mysql.sock     # Unix socket 连接路径（本地连接更快）
port={{ mysql_port_value }}                # TCP 端口（远程连接使用）

# =============================================================================
# MySQL 服务端核心配置
# =============================================================================
[mysqld]
# --- 基础运行参数 ---
user=mysql                                 # 运行用户（与 systemd 单元一致）
basedir=/usr                               # MySQL 安装根目录（Ubuntu apt 安装位置）
datadir={{ mysql_data_dir }}               # 数据目录（所有表、索引、数据文件）
tmpdir={{ mysql_tmp_dir }}                 # 临时文件目录（排序、临时表等）
socket={{ mysql_run_dir }}/mysql.sock      # Unix socket 路径（本地客户端连接）
pid-file={{ mysql_run_dir }}/mysql.pid     # 进程 PID 文件路径
port={{ mysql_port_value }}                # 监听端口
bind-address=0.0.0.0                       # 监听所有网络接口（允许远程连接）
skip-name-resolve=ON                       # 跳过 DNS 解析（提升连接速度，授权时需用 IP）
server-id={{ mysql_server_id_value }}      # 服务器唯一 ID（复制必须，全机唯一）
local-infile=OFF                           # 禁用 LOAD DATA LOCAL（安全考虑，防止读取客户端文件）

# --- 字符集 / 排序规则 / 时区 / 标识符大小写 ---
character-set-server={{ mysql_character_set }}           # 服务端字符集，默认 utf8mb4
collation-server={{ mysql_collation }}                   # 排序规则，默认 utf8mb4_general_ci
default-time-zone={{ mysql_timezone }}                   # 默认时区，东八区
lower-case-table-names={{ mysql_lower_case_table_names }} # 表名大小写敏感：1=不敏感（Linux 推荐）

# --- 错误日志 / 慢查询日志 ---
log-error={{ mysql_log_dir }}/error.log                  # 错误日志路径
slow-query-log=ON                                        # 启用慢查询日志
slow-query-log-file={{ mysql_log_dir }}/slow.log         # 慢查询日志路径
long-query-time={{ mysql_long_query_time }}              # 慢查询阈值（秒），超过此时间记录

# =============================================================================
# Binlog 配置（用于数据恢复 PITR + 复制基础）
# =============================================================================
log-bin={{ mysql_binlog_dir }}/binlog                    # binlog 文件前缀（二进制日志）
binlog-format=ROW                                        # 格式：ROW（行变更），复制最安全
sync-binlog={{ mysql_sync_binlog }}                      # 每次提交同步 binlog 到磁盘，1=最安全
max-binlog-size={{ mysql_max_binlog_size }}              # 单个 binlog 文件最大大小
binlog-expire-logs-seconds={{ mysql_binlog_expire_logs_seconds }} # binlog 过期时间（秒），默认 7 天

# --- 非 standalone 拓扑才启用的复制参数 ---
{% if topology != 'standalone' %}
gtid-mode=ON                                             # 启用 GTID（全局事务标识符）
enforce-gtid-consistency=ON                              # 强制 GTID 一致性（确保复制安全）
relay-log={{ mysql_binlog_dir }}/relay-bin               # 中继日志路径（从库重放 binlog 使用）
{% if mysql_node_role | default('') == 'replica' %}
# 从库强制只读：阻止业务直接写入从库导致主从数据分叉
# 复制线程与 CHANGE REPLICATION SOURCE 等复制管理语句不受影响
read-only=ON
super-read-only=ON
{% endif %}
{% endif %}

# =============================================================================
# InnoDB 存储引擎核心配置
# =============================================================================
# 缓冲池大小：分配内存的 55%（MySQL 官方推荐 50%-75%）
innodb-buffer-pool-size={{ ((mysql_memory_mb_value | int) * 55 / 100) | int }}M

# 刷盘方式：O_DIRECT 绕过操作系统缓存，直接写磁盘
# 避免双重缓存，适合有电池保护写缓存的 RAID 控制器
innodb-flush-method=O_DIRECT

# 事务提交时刷日志到磁盘：1=每次提交都刷（最安全，性能最低）
innodb-flush-log-at-trx-commit={{ mysql_flush_log_at_trx_commit }}

# InnoDB I/O 能力：告诉 InnoDB 磁盘的 IOPS 能力
# 2000 适合 SSD，HDD 建议 200-400
innodb-io-capacity={{ mysql_io_capacity }}

# 最大连接数（按内存梯度计算，默认值见 Playbook）
max-connections={{ mysql_max_connections }}

# =============================================================================
# Redo Log 配置（InnoDB 崩溃恢复必需）
# =============================================================================
innodb-log-group-home-dir={{ mysql_redo_dir }}           # redo log 目录

# MySQL 8.0.30+ 使用 innodb-redo-log-capacity 控制 redo log 总大小
# 旧版本使用 innodb-log-file-size 控制单个文件大小
{% if mysql_version_value in ['8.0', '8.4'] %}
innodb-redo-log-capacity={{ mysql_redo_capacity }}
{% else %}
innodb-log-file-size={{ mysql_redo_capacity }}
{% endif %}

# =============================================================================
# X Protocol 禁用（版本相关）
# =============================================================================
# X Protocol 是 MySQL 的 NoSQL 部分，我们不需要，禁用节省资源
{% if mysql_version_value in ['8.0', '8.4'] %}
mysqlx=0                                                   # 8.0/8.4 直接禁用
{% elif mysql_version_value == '5.7' %}
loose-mysqlx=0                                             # 5.7 使用 loose 前缀（参数可能不存在）
{% endif %}

# =============================================================================
# Group Replication 配置（仅 mgr_3 拓扑）
# =============================================================================
# 注意：这里只做配置就绪，实际启动组复制需要平台侧执行 START GROUP_REPLICATION
{% if topology == 'mgr_3' %}
# 加载 Group Replication 插件
plugin-load-add=group_replication.so

# MySQL 8.0.26 之前需要设置事务写集提取（8.4 已移除此参数）
{% if mysql_version_value != '8.4' %}
transaction-write-set-extraction=XXHASH64                 # 使用 XXHASH64 算法提取写集
{% endif %}

# GR 组 UUID（所有节点必须相同）
loose-group-replication-group-name={{ mgr_group_name }}

# 不在启动时自动加入组（由平台侧手动控制加入时机）
loose-group-replication-start-on-boot=OFF

# 本节点用于 GR 通信的地址和端口
loose-group-replication-local-address={{ ansible_host | default(inventory_hostname) }}:{{ mysql_gr_port_value }}

# 组内所有节点的种子列表（用于新节点发现和连接）
loose-group-replication-group-seeds={% for host in ansible_play_hosts_all %}{{ hostvars[host].ansible_host | default(host) }}:{{ mysql_gr_port_value }}{% if not loop.last %},{% endif %}{% endfor %}

# IP 白名单：只允许组内节点 IP 加入（安全限制）
loose-group-replication-ip-allowlist={% for host in ansible_play_hosts_all %}{{ hostvars[host].ansible_host | default(host) }}{% if not loop.last %},{% endif %}{% endfor %}

# 单主模式：只有 primary 节点可写，replica 只读（推荐生产使用）
loose-group-replication-single-primary-mode=ON

# 关闭强制更新检查：单主模式下不需要（多主模式才需要）
loose-group-replication-enforce-update-everywhere-checks=OFF
{% endif %}