用途:在 MariaDB 模式上线前审查其结构,或审计现有模式中的存储引擎、索引、命名、规范化等问题。它不教语法,而是按固定 10 维度清单执行检查并生成分级报告,每条发现都引用解释底层规则的规范技能。
主要能力:按顺序运行全部 10 个维度,不因模式“看起来没问题”而跳过。维度包括存储引擎(事务表应为 InnoDB,标记 MyISAM)、主键(每表须有 PK,标记 UUID 文本 PK)、索引(复合列顺序、冗余索引、外键索引)、字符集与排序规则(文本列应为 utf8mb4,标记 utf8/latin1)、规范化(重复组、无理由反规范化)、多租户(检测 tenant_id,标记缺少最左租户索引)、命名(大小写一致性、保留字、Frappe tab 模式)、约束(缺失 CHECK/FK)、数据类型(金额用 DECIMAL、过大 VARCHAR、TEXT 误用)、JSON(JSON 列缺少 CHECK (JSON_VALID(col)))。
使用方式:对模式中每张表按决策树逐项检查,每条发现标注 BLOCKER、WARNING 或 SUGGESTION,并引用对应规范技能。输出单张发现表(维度、严重级别、位置、问题、修复、技能引用),按 BLOCKER、WARNING、SUGGESTION 排序,最后给出结论行。结论规则:存在任一 BLOCKER 则 FAIL,模式不得上线;无 BLOCKER 但有 WARNING 则 PASS WITH WARNINGS;均无则 PASS。干净模式也需输出报告,表格为空、结论为 PASS。
适用场景:审查拟上线的模式、审计现有模式、检查迁移 DDL。
限制:本技能审查结构而非数据,不检查行内容或运行性能分析。调优单个慢查询应使用 mariadb-agents-query-optimizer;从零编写新 DDL 应直接使用 mariadb-impl-schema-design 和 mariadb-syntax-sql-ddl。MariaDB 的 JSON 是 LONGTEXT 别名而非原生二进制,缺少 JSON_VALID 检查的 JSON 列会被静默接受非法内容,因此该问题定为 WARNING。