affaan-m/mysql-patterns

面向生产后端的 MySQL 与 MariaDB schema、查询、索引、事务、复制和连接池模式。用于设计 MySQL 或 MariaDB schema 与索引，或当查询、事务或副本出现延迟时使用。

编程协作开发 Agent Agent 技能调研 MySQL 数据库模式索引与查询优化事务复制配置连接池管理表结构设计

技术栈: cursor24万+许可证: MIT开发者: affaan-m

Skill 介绍Skill 文件

重要提示：本站仅作 Skill 资源导航与收录，正文以 GitHub 原仓库为准，版权归原项目所有。

在 GitHub 查看 ↗

原文译文

以下为摘要预览，完整内容请查看 GitHub 原文。

MySQL Patterns

Use this skill when working on MySQL or MariaDB schema design, migrations, slow-query investigation, queue-style transactions, connection pools, or production database configuration. Prefer exact version checks before applying a feature-specific pattern because MySQL and MariaDB have diverged in several SQL details.

Activation

Designing MySQL or MariaDB tables, indexes, and constraints
Reviewing migrations before they run on large production tables
Debugging slow queries, lock waits, deadlocks, or connection exhaustion
Adding keyset pagination, upserts, full-text search, JSON columns, or queues
Configuring application connection pools, read replicas, TLS, or slow logs

Version Check

Start by identifying the engine and version:

SELECT VERSION();
SHOW VARIABLES LIKE 'version_comment';

Keep MySQL and MariaDB guidance separate when syntax differs:

MySQL documents row aliases as the replacement for VALUES(col) in ON DUPLICATE KEY UPDATE; VALUES(col) is deprecated there.
MariaDB documents VALUES(col) as the supported way to reference inserted values in ON DUPLICATE KEY UPDATE; use it for cross-engine compatibility.
`S…

以下为摘要预览，完整内容请查看 GitHub 原文。

MySQL 模式

在使用 MySQL 或 MariaDB 进行 schema 设计、迁移、慢查询分析、队列式事务、连接池或生产数据库配置时使用此技能。在应用某个特定版本的模式之前，优先进行精确的版本检查，因为 MySQL 和 MariaDB 在多项 SQL 细节上已经产生分歧。

激活场景

设计 MySQL 或 MariaDB 的表、索引和约束
在大型生产表上运行迁移之前进行评审
调试慢查询、锁等待、死锁或连接耗尽
添加键集分页、upsert、全文检索、JSON 列或队列
配置应用连接池、只读副本、TLS 或慢查询日志

版本检查

首先识别引擎与版本：

SELECT VERSION();
SHOW VARIABLES LIKE 'version_comment';

当语法存在差异时，将 MySQL 与 MariaDB 的指导分开：

MySQL 文档将行别名（row alias）作为 ON DUPLICATE KEY UPDATE 中 VALUES(col) 的替代方式；VALUES(col) 在 MySQL 中已被弃用。
MariaDB 文档将 VALUES(col) 作为 ON DUPLICATE KEY UPDATE 中引用已插入值的受支持方式；为实现跨引擎兼容，请使用它。
SKIP LOCKED 仅适用于类队列的工作负载。它会跳过被锁定的行并可能返回不一致的视图，因此不要将其用于通用记账或对完整性敏感的读取。

Schema 默认值

CREATE TABLE orders (
    id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
    account_id BIGINT UNSIGNED NOT NULL,
    status VARCHAR(32) NOT NULL,
    total DECIMAL(15, 2) NOT NULL,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    deleted_at DATETIME NULL,
    PRIMARY KEY (id),
    KEY idx_orders_account_status_created (account_id, status, created_at),
    KEY idx_orders_active (account_id, deleted_at…

重要提示：源文件不在本站托管，请通过 GitHub 查看与下载。

索引更新于 8/25/2026, 9:18:05 PMGitHub ↗

SKILL.md11.9 KB在 GitHub 查看 ↗