数据库操作 Skill

1. MySQL 数据库操作 Skill

MySQL 数据库安全操作 Skill，含 DDL/DML 规范、防误删规则、备份流程

Prompt

---
name: 数据库规范
description: 数据库优先原则（先改库再改代码）、goctl-model.sh 生成命令、表创建规范（NULL 值、字段命名、索引）、禁止操作（DROP/DELETE/TRUNCATE）、软删除规则、批量操作限制。
---

# 数据库规范

## 数据库信息

- **数据库名**: db_buffett
- **表前缀**: bs_
- **字符集**: utf8mb4

## ⚠️ 数据库优先修改原则（极其重要）

> **核心原则**：涉及数据库变更的需求，必须 **先修改数据库，再修改代码**。

### 执行流程

1. **判断需求类型**
   - 纯前端样式修改 → 直接修改前端代码
   - 涉及数据字段变更 → 进入步骤 2

2. **检查数据库结构**
   - **必须首先**查看当前数据库中有哪些表
   - 使用 MCP 数据库工具查询表结构
   - 检查是否有关联表需要同步修改

3. **先执行数据库变更**
   - 执行 `ALTER TABLE` 语句
   - 验证变更成功
   - **切记不可执行 DROP/TRUNCATE**

4. **再修改后端代码（强制同步 Model）**
   ```bash
   cd backend
   ./goctl-model.sh <group_name> <table_name>

• 绝对禁止手动修改 model/*_gen.go 文件

5. 最后修改前端代码

绝对禁止的操作

-- ❌ 绝对禁止
DROP TABLE xxx;
DROP DATABASE xxx;
DELETE FROM table_name WHERE id = 1;  -- 禁止物理删除
UPDATE table_name SET column = value;  -- 禁止无 WHERE 条件
TRUNCATE TABLE xxx;

-- ✅ 必须使用软删除
UPDATE table_name SET status = -1, deleted_at = NOW() WHERE id = 1;

数据表创建规范

字段 NULL 值规范

字段命名规范

表创建标准模板

CREATE TABLE bs_表名 (
    id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键ID',
    name VARCHAR(100) NOT NULL DEFAULT '' COMMENT '名称',
    status TINYINT NOT NULL DEFAULT 1 COMMENT '状态: 1=在线, -1=下线',
    sort INT NOT NULL DEFAULT 0 COMMENT '排序值',
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    PRIMARY KEY (id),
    KEY idx_status (status)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='表注释';

常用字段约定

防止数据丢失的强制规则

UPDATE 操作步骤

-- 步骤1: 先查看要更新的数据（必须执行）
SELECT * FROM table_name WHERE [条件];

-- 步骤2: 确认影响行数
SELECT COUNT(*) FROM table_name WHERE [条件];

-- 步骤3: 批量更新超过10条时，必须先询问用户确认
-- 步骤4: 首次更新建议加 LIMIT 1 测试
UPDATE table_name SET column = value WHERE [条件] LIMIT 1;

批量操作限制

• 批量 INSERT: 单次不超过 100 条
• 批量 UPDATE: 单次不超过 50 条
• 批量软删除: 单次不超过 10 条，必须用户确认

禁止的高危操作

• ❌ ALTER TABLE DROP COLUMN
• ❌ ALTER TABLE MODIFY 缩小字段长度
• ❌ 删除有外键关联的父记录
• ❌ 在生产数据上直接执行未经测试的 SQL

字段类型选择

索引规范

-- 1. 主键索引（必须）
PRIMARY KEY (id)

-- 2. 唯一索引（业务唯一字段）
UNIQUE KEY uk_user_uuid (user_uuid)

-- 3. 普通索引（查询条件字段）
KEY idx_status (status)
KEY idx_category_id (category_id)

-- 4. 联合索引（多字段查询，注意顺序）
KEY idx_category_status (category_id, status)

索引命名规范:

• 主键: PRIMARY KEY
• 唯一索引: uk_字段名
• 普通索引: idx_字段名
• 联合索引: idx_字段1_字段2

字段修改风险等级