Agent skill

database-ops

定义了RuoYi-Vue-Plus框架下的数据库结构设计标准，规范了数据库初始化、版本升级DDL变更及Schema准备流程。核心要求包括强制包含标准审计字段、遵循小写下划线命名与InnoDB存储规范、禁止使用物理外键以提升性能，以及根据配置文件动态适配MySQL或Oracle数据库的SQL生成策略。

View SKILL.md on GitHub Repository

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/database-ops

SKILL.md

Database-Ops 数据库设计

技能说明

本技能专为 RuoYi-Vue-Plus 框架的数据库设计场景定制，确保所有数据库操作符合框架规范，保证系统的可维护性、可扩展性和性能最优。

触发条件

必须触发的场景（强制）

关键词触发：用户提及 DDL、CREATE TABLE、ALTER TABLE、DROP TABLE、建表、删表、改表、Schema、数据库设计、表结构设计
行为触发：
- 需要创建新的业务表或系统表时
- 需要修改现有表结构（添加/删除/修改字段）时
- 准备数据库初始化脚本时
- 版本升级需要执行 DDL 变更时
- 使用代码生成器前需要准备表结构时

应主动触发的场景（建议）

用户描述业务需求但未明确提及数据库时，应主动询问是否需要设计数据表
发现用户提供的 SQL 语句不符合框架规范时，应主动应用本技能进行修正

执行流程

配置文件读取：首先读取 ruoyi-admin/src/main/resources/application-dev.yml 确定数据库类型
数据库类型判断：
- 如果配置中只有一个数据源，自动使用对应数据库的 SQL 语法
- 如果配置中有多个数据源，必须询问用户在哪个数据库中执行操作
系统表检查（规范5）：检查系统表是否已初始化
表结构设计：按照核心规范1-4设计表结构
生成 SQL 脚本：输出符合目标数据库语法的 DDL 语句
检查清单验证：对照检查清单进行最终验证

核心规范

规范1：强制包含标准审计字段 [MANDATORY]

适用范围：所有业务表（bus_）和系统表（sys_），字典表和配置表除外

必须包含的字段（顺序不可更改，必须放在业务字段之后、主键定义之前）：

create_by varchar(64) DEFAULT '' COMMENT '创建者'
create_time datetime DEFAULT NULL COMMENT '创建时间'
update_by varchar(64) DEFAULT '' COMMENT '更新者'
update_time datetime DEFAULT NULL COMMENT '更新时间'
remark varchar(500) DEFAULT NULL COMMENT '备注'
del_flag char(1) DEFAULT '0' COMMENT '删除标志（0代表存在 2代表删除）'

技术原因：

这些字段对应 BaseEntity 基类，框架会自动填充创建/更新信息
del_flag 支持 MyBatis-Plus 的逻辑删除功能，避免物理删除数据
缺少任何一个字段都会导致框架的自动审计功能失效 示例代码：

sql

CREATE TABLE `sys_user` (
  `user_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '用户ID',
  `user_name` varchar(30) NOT NULL COMMENT '用户账号',
  `nick_name` varchar(30) NOT NULL COMMENT '用户昵称',
  `dept_id` bigint(20) DEFAULT NULL COMMENT '部门ID',
  -- ========== 标准审计字段 Start（必须严格按此顺序） ==========
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `del_flag` char(1) DEFAULT '0' COMMENT '删除标志（0代表存在 2代表删除）',
  -- ========== 标准审计字段 End ==========
  PRIMARY KEY (`user_id`)
) ENGINE=InnoDB AUTO_INCREMENT=100 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='用户信息表';

规范2：遵循命名与存储规范 [MANDATORY]

命名规范（严格执行）：

表名：必须使用小写字母 + 下划线（snake_case），格式为 前缀_业务名
- 系统表前缀：sys_（如 sys_user、sys_role）
- 业务表前缀：bus_（如 bus_order、bus_product）
- 临时表前缀：tmp_（如 tmp_import_data）
字段名：必须使用小写字母 + 下划线，禁止使用驼峰命名
- ✅ 正确：user_name, order_id, create_time
- ❌ 错误：userName, orderId, createTime
主键命名：必须为 表名单数_id（如 user_id、order_id）
索引命名：
- 普通索引：idx_字段名（如 idx_user_name）
- 唯一索引：uk_字段名（如 uk_order_sn）
- 联合索引：idx_字段1_字段2（如 idx_dept_id_status）

存储规范（强制）：

存储引擎：必须使用 InnoDB（支持事务、行级锁、外键约束）
字符集：必须使用 utf8mb4（支持完整的 Unicode 字符，包括 emoji）
排序规则：必须使用 utf8mb4_general_ci（不区分大小写）
主键类型：必须使用 bigint(20) NOT NULL AUTO_INCREMENT
自增起始值：系统表从 100 开始，业务表从 1 开始 示例代码：

sql

-- ✅ 正确示例：完全符合规范
CREATE TABLE `bus_order` (
  `order_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '订单ID',
  `order_sn` varchar(64) NOT NULL COMMENT '订单编号',
  `order_amount` decimal(10,2) NOT NULL COMMENT '订单金额',
  `pay_status` char(1) DEFAULT '0' COMMENT '支付状态（0未支付 1已支付）',
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `del_flag` char(1) DEFAULT '0' COMMENT '删除标志（0代表存在 2代表删除）',
  PRIMARY KEY (`order_id`),
  UNIQUE KEY `uk_order_sn` (`order_sn`),
  KEY `idx_pay_status` (`pay_status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='业务订单表';

规范3：禁止使用物理外键 [MANDATORY]

核心原则：严禁在表级别建立物理外键约束（FOREIGN KEY）

技术原因：

性能问题：物理外键会在 INSERT/UPDATE/DELETE 操作时触发额外的约束检查，降低并发性能
锁表风险：级联更新/删除可能导致大范围锁表，影响系统可用性
分库分表限制：物理外键无法跨库使用，限制了水平扩展能力
灵活性降低：业务逻辑变更时需要先删除外键约束，增加维护成本

正确做法：

使用普通索引（KEY）代替外键约束，仅用于加速关联查询
在业务代码层面通过 Service 层保证数据一致性
使用 MyBatis-Plus 的 @TableField 注解配置逻辑关联 示例对比：

sql

-- ❌ 错误示例：使用了物理外键约束
CREATE TABLE `bus_order` (
  `order_id` bigint(20) NOT NULL AUTO_INCREMENT,
  `user_id` bigint(20) NOT NULL COMMENT '下单用户ID',
  PRIMARY KEY (`order_id`),
  CONSTRAINT `fk_order_user` FOREIGN KEY (`user_id`) REFERENCES `sys_user` (`user_id`) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- ✅ 正确示例：仅创建普通索引
CREATE TABLE `bus_order` (
  `order_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '订单ID',
  `user_id` bigint(20) DEFAULT NULL COMMENT '下单用户ID',
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `del_flag` char(1) DEFAULT '0' COMMENT '删除标志（0代表存在 2代表删除）',
  PRIMARY KEY (`order_id`),
  KEY `idx_user_id` (`user_id`) -- 仅创建索引以加速查询，不建立外键约束
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='业务订单表';

规范4：根据数据库类型生成对应 SQL [MANDATORY]

配置文件读取：

路径：ruoyi-admin/src/main/resources/application-dev.yml
关键配置：spring.datasource.dynamic.datasource

判断逻辑：

单数据源场景：
- 如果只配置了 MySQL，自动生成 MySQL 语法的 SQL
- 如果只配置了 Oracle，自动生成 Oracle 语法的 SQL
- 如果只配置了 PostgreSQL，自动生成 PostgreSQL 语法的 SQL
多数据源场景：
- 必须询问用户："检测到多个数据源（MySQL、Oracle），请问要在哪个数据库中创建此表？"
- 等待用户明确回复后再生成对应语法的 SQL

数据类型映射差异：

通用类型	MySQL	Oracle	PostgreSQL
主键	bigint(20) AUTO_INCREMENT	NUMBER(20) + SEQUENCE	bigserial
长文本	varchar(255)	VARCHAR2(255)	varchar(255)
日期时间	datetime	DATE	timestamp
小数	decimal(10,2)	NUMBER(10,2)	numeric(10,2)
布尔	char(1)	CHAR(1)	char(1)

示例：

sql

-- MySQL 语法
CREATE TABLE `bus_order` (
  `order_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '订单ID',
  `order_time` datetime DEFAULT NULL COMMENT '下单时间',
  PRIMARY KEY (`order_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- Oracle 语法
CREATE TABLE bus_order (
  order_id NUMBER(20) NOT NULL,
  order_time DATE DEFAULT NULL,
  PRIMARY KEY (order_id)
);
CREATE SEQUENCE seq_bus_order START WITH 1 INCREMENT BY 1;
COMMENT ON TABLE bus_order IS '订单表';
COMMENT ON COLUMN bus_order.order_id IS '订单ID';
COMMENT ON COLUMN bus_order.order_time IS '下单时间';

规范5：系统表初始化检查 [MANDATORY]

执行时机：在创建任何业务表之前，必须先确保系统表已初始化

检查流程：

读取配置文件：ruoyi-admin/src/main/resources/application-dev.yml
确定数据库类型：
- 如果是 MySQL，检查 script/sql/mysql/ 目录
- 如果是 Oracle，检查 script/sql/oracle/ 目录
- 如果是 PostgreSQL，检查 script/sql/postgresql/ 目录
验证系统表：
- 读取对应数据库目录下的 SQL 初始化脚本
- 检查以下核心系统表是否已存在：
  - sys_user（用户表）
  - sys_role（角色表）
  - sys_menu（菜单表）
  - sys_dept（部门表）
  - sys_dict_type（字典类型表）
  - sys_dict_data（字典数据表）
执行初始化：
- 如果系统表不存在，必须先提示用户："检测到系统表未初始化，需要先执行 script/sql/mysql/ry-vue-plus.sql 初始化系统表，是否继续？"
- 等待用户确认后，提供完整的初始化 SQL 脚本路径

重要提示：

系统表必须在业务表之前创建，否则可能导致权限、字典等功能异常
不同数据库的初始化脚本语法不同，必须使用对应数据库的脚本

禁止事项 [CRITICAL]

数据库设计层面

❌ 禁止省略 COMMENT 注释：所有表和字段必须有中文注释说明业务含义，方便团队协作
❌ 禁止使用物理外键：严禁使用 FOREIGN KEY 约束，必须通过业务层维护关联
❌ 禁止省略审计字段：所有业务表必须包含完整的 6 个标准审计字段（create_by、create_time、update_by、update_time、remark、del_flag）
❌ 禁止使用驼峰命名：表名和字段名必须使用 snake_case，不能使用 camelCase
❌ 禁止使用 MyISAM 引擎：必须使用 InnoDB 引擎以支持事务和行级锁
❌ 禁止使用 utf8 字符集：必须使用 utf8mb4 以支持完整 Unicode（包括 emoji）
❌ 禁止使用 SELECT * 视图：视图定义必须明确列出所有字段

字段定义层面

❌ 禁止使用 TEXT/BLOB 类型：应使用 varchar 并指定合理长度，便于索引优化
❌ 禁止不指定字段长度：varchar 和 char 必须明确指定长度（如 varchar(255)）
❌ 禁止使用 NULL 作为默认值（特殊情况除外）：优先使用空字符串 '' 或 0 作为默认值
❌ 禁止主键使用 int 类型：必须使用 bigint(20) 以避免 ID 溢出
❌ 禁止金额字段使用 float/double：必须使用 decimal(10,2) 避免精度丢失

索引设计层面

❌ 禁止在低基数字段上建索引：如性别（只有男/女）不适合建索引
❌ 禁止过多索引：单表索引数量不超过 5 个，避免影响写入性能
❌ 禁止联合索引字段顺序错误：必须按照查询频率和区分度排序（最常用且区分度高的在前）

操作流程层面

❌ 禁止跳过配置文件读取：必须先读取 application-dev.yml 确定数据库类型
❌ 禁止在多数据源场景下擅自决定：检测到多数据源时必须询问用户选择哪个数据库
❌ 禁止在系统表未初始化时创建业务表：必须先确保系统表已存在
❌ 禁止直接修改系统表结构：系统表（sys_*）结构由框架维护，除非有充分理由
❌ 禁止在生产环境直接执行 DDL：必须先在开发/测试环境验证后再发布

安全与性能层面

❌ 禁止存储明文密码：密码字段必须使用加密存储
❌ 禁止在 SQL 中硬编码敏感信息：如数据库连接字符串、密钥等
❌ 禁止创建无主键表：所有表必须有主键
❌ 禁止使用保留关键字作为表名或字段名：如 order、user、group 等（应加前缀如 bus_order）

参考代码资源

框架核心文件

系统表初始化脚本（MySQL）：script/sql/mysql/ry-vue-plus.sql
系统表初始化脚本（Oracle）：script/sql/oracle/ry-vue-plus.sql
基础实体类：ruoyi-common/src/main/java/org/dromara/common/core/domain/BaseEntity.java
- 作用：定义标准审计字段的 Java 映射
用户实体示例：ruoyi-system/src/main/java/org/dromara/system/domain/SysUser.java
- 作用：参考如何继承 BaseEntity 并定义业务字段
配置文件：ruoyi-admin/src/main/resources/application-dev.yml
- 作用：读取数据源配置，确定目标数据库类型

数据类型参考

MySQL 常用类型

主键：bigint(20) NOT NULL AUTO_INCREMENT
字符串（短）：varchar(64) / varchar(255)
字符串（长）：varchar(500) / varchar(2000)
状态标识：char(1)
金额：decimal(10,2)
日期时间：datetime
整数：int(11) / bigint(20)

Oracle 常用类型

主键：NUMBER(20) + SEQUENCE
字符串：VARCHAR2(64) / VARCHAR2(255)
状态标识：CHAR(1)
金额：NUMBER(10,2)
日期时间：DATE
整数：NUMBER(11) / NUMBER(20)

检查清单（执行前必查）

结构完整性检查

是否包含所有 6 个标准审计字段（create_by, create_time, update_by, update_time, remark, del_flag）
审计字段顺序是否正确（必须在业务字段之后、主键定义之前）
是否定义了主键，且主键类型为 bigint(20) NOT NULL AUTO_INCREMENT

命名规范检查

表名是否使用 snake_case 且有正确前缀（sys_/bus_/tmp_）
字段名是否全部使用 snake_case（无驼峰命名）
索引命名是否符合规范（idx_* 或 uk_*）

存储配置检查

引擎是否为 InnoDB
字符集是否为 utf8mb4
排序规则是否为 utf8mb4_general_ci

约束与索引检查

是否存在物理外键约束（如有必须删除，改用普通索引 + 业务层维护）
关联字段是否创建了普通索引（KEY）以加速查询
唯一性约束是否使用 UNIQUE KEY

字段类型检查

所有 varchar 和 char 字段是否指定了合理的长度
金额字段是否使用 decimal 而非 float/double
日期时间字段是否使用 datetime 而非 timestamp

注释完整性检查

表是否有 COMMENT 注释说明业务含义
所有字段是否都有 COMMENT 注释（必须是中文描述）
状态字段的注释是否说明了枚举值含义（如：0未支付 1已支付）

环境适配检查

是否已读取 application-dev.yml 确定数据库类型
多数据源场景是否已询问用户选择目标数据库
生成的 SQL 语法是否匹配目标数据库（MySQL/Oracle/PostgreSQL）
是否已检查系统表初始化状态

常见问题与解决方案

Q1：为什么必须使用 bigint(20) 而不是 int？

A：int 最大值约 21 亿，在高并发系统中容易溢出。bigint 最大值约 922 亿亿，足够使用。

Q2：为什么禁止使用物理外键？

A：物理外键会严重影响并发性能，且在分库分表场景下无法使用。建议通过业务层 Service 保证数据一致性。

Q3：如何处理已存在的表需要新增字段的情况？

A：使用 ALTER TABLE 语句，新增字段必须放在标准审计字段之前：

sql

ALTER TABLE `bus_order` 
ADD COLUMN `discount_amount` decimal(10,2) DEFAULT 0.00 COMMENT '优惠金额' AFTER `order_amount`;

Q4：如何处理多租户场景的表设计？

A：在业务表中添加 tenant_id 字段，并创建索引：

sql

`tenant_id` varchar(20) DEFAULT '000000' COMMENT '租户编号',
KEY `idx_tenant_id` (`tenant_id`)

Q5：表名超过 MySQL 64 字符限制怎么办？

A：使用缩写或重新设计表名，确保表名简洁且有意义。例如：

❌ bus_user_order_delivery_address_history (太长)
✅ bus_delivery_addr_history (简洁明了)

输出格式要求（⭐ 关键）

核心原则：必须输出完整可执行的 SQL 脚本文件

强制要求：

所有 SQL 语句必须整合为一个完整的脚本文件格式
脚本必须包含文件头注释、数据库选择、表创建等完整内容
脚本必须可以直接复制粘贴到数据库管理工具中一键执行
多个表的情况下，必须统一在一个脚本中按逻辑顺序排列

标准 SQL 脚本文件格式（MySQL）

sql

-- ====================================================
-- RuoYi-Vue-Plus 业务表 DDL 脚本
-- ====================================================
-- 功能模块：订单管理模块
-- 创建时间：2026-01-26
-- 数据库类型：MySQL 5.7+
-- 执行说明：在开发环境执行前请先备份数据库
-- ====================================================

-- 切换到目标数据库（根据实际情况修改数据库名）
USE `ry-vue-plus`;

-- ====================================================
-- 表1：bus_order (业务订单表)
-- 说明：存储用户订单信息，支持逻辑删除
-- ====================================================

DROP TABLE IF EXISTS `bus_order`;

CREATE TABLE `bus_order` (
  -- 业务主键
  `order_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '订单ID',
  
  -- 业务字段
  `order_sn` varchar(64) NOT NULL COMMENT '订单编号',
  `user_id` bigint(20) NOT NULL COMMENT '下单用户ID',
  `order_amount` decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT '订单金额',
  `pay_status` char(1) DEFAULT '0' COMMENT '支付状态（0未支付 1已支付 2已退款）',
  
  -- 标准审计字段
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `del_flag` char(1) DEFAULT '0' COMMENT '删除标志（0代表存在 2代表删除）',
  
  -- 主键与索引
  PRIMARY KEY (`order_id`),
  UNIQUE KEY `uk_order_sn` (`order_sn`),
  KEY `idx_user_id` (`user_id`),
  KEY `idx_pay_status` (`pay_status`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='业务订单表';

-- ====================================================
-- 表2：bus_order_item (订单明细表)
-- 说明：存储订单商品明细信息
-- ====================================================

DROP TABLE IF EXISTS `bus_order_item`;

CREATE TABLE `bus_order_item` (
  -- 业务主键
  `item_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '明细ID',
  
  -- 业务字段
  `order_id` bigint(20) NOT NULL COMMENT '订单ID',
  `product_id` bigint(20) NOT NULL COMMENT '商品ID',
  `product_name` varchar(255) NOT NULL COMMENT '商品名称',
  `quantity` int(11) NOT NULL DEFAULT 1 COMMENT '购买数量',
  `price` decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT '商品单价',
  
  -- 标准审计字段
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `del_flag` char(1) DEFAULT '0' COMMENT '删除标志（0代表存在 2代表删除）',
  
  -- 主键与索引
  PRIMARY KEY (`item_id`),
  KEY `idx_order_id` (`order_id`),
  KEY `idx_product_id` (`product_id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='订单明细表';

-- ====================================================
-- 脚本执行完成提示
-- ====================================================
-- 执行成功后，请验证表结构：
-- DESC bus_order;
-- DESC bus_order_item;
-- ====================================================

标准 SQL 脚本文件格式（Oracle）

sql

-- ====================================================
-- RuoYi-Vue-Plus 业务表 DDL 脚本
-- ====================================================
-- 功能模块：订单管理模块
-- 创建时间：2026-01-26
-- 数据库类型：Oracle 11g+
-- 执行说明：在开发环境执行前请先备份数据库
-- ====================================================

-- 删除已存在的表（如果存在）
BEGIN
   EXECUTE IMMEDIATE 'DROP TABLE bus_order CASCADE CONSTRAINTS';
EXCEPTION
   WHEN OTHERS THEN NULL;
END;
/

BEGIN
   EXECUTE IMMEDIATE 'DROP SEQUENCE seq_bus_order';
EXCEPTION
   WHEN OTHERS THEN NULL;
END;
/

-- ====================================================
-- 表1：bus_order (业务订单表)
-- 说明：存储用户订单信息，支持逻辑删除
-- ====================================================

CREATE TABLE bus_order (
  order_id NUMBER(20) NOT NULL,
  order_sn VARCHAR2(64) NOT NULL,
  user_id NUMBER(20) NOT NULL,
  order_amount NUMBER(10,2) DEFAULT 0.00 NOT NULL,
  pay_status CHAR(1) DEFAULT '0',
  create_by VARCHAR2(64) DEFAULT '',
  create_time DATE DEFAULT NULL,
  update_by VARCHAR2(64) DEFAULT '',
  update_time DATE DEFAULT NULL,
  remark VARCHAR2(500) DEFAULT NULL,
  del_flag CHAR(1) DEFAULT '0',
  PRIMARY KEY (order_id)
);

-- 创建序列
CREATE SEQUENCE seq_bus_order START WITH 1 INCREMENT BY 1 NOCACHE;

-- 添加表注释
COMMENT ON TABLE bus_order IS '业务订单表';
COMMENT ON COLUMN bus_order.order_id IS '订单ID';
COMMENT ON COLUMN bus_order.order_sn IS '订单编号';
COMMENT ON COLUMN bus_order.user_id IS '下单用户ID';
COMMENT ON COLUMN bus_order.order_amount IS '订单金额';
COMMENT ON COLUMN bus_order.pay_status IS '支付状态（0未支付 1已支付 2已退款）';
COMMENT ON COLUMN bus_order.create_by IS '创建者';
COMMENT ON COLUMN bus_order.create_time IS '创建时间';
COMMENT ON COLUMN bus_order.update_by IS '更新者';
COMMENT ON COLUMN bus_order.update_time IS '更新时间';
COMMENT ON COLUMN bus_order.remark IS '备注';
COMMENT ON COLUMN bus_order.del_flag IS '删除标志（0代表存在 2代表删除）';

-- 创建索引
CREATE UNIQUE INDEX uk_order_sn ON bus_order(order_sn);
CREATE INDEX idx_user_id ON bus_order(user_id);
CREATE INDEX idx_pay_status ON bus_order(pay_status);

-- ====================================================
-- 脚本执行完成
-- ====================================================

输出要求总结

必须包含的部分（按顺序）：

✅ 脚本文件头注释（功能模块、创建时间、数据库类型、执行说明）
✅ 数据库选择语句（MySQL: USE 语句；Oracle: 连接到对应schema）
✅ 每个表的完整 DDL：
- 表头注释（表名、说明）
- DROP TABLE IF EXISTS 语句
- CREATE TABLE 语句（含所有字段、约束、索引）
- Oracle 需额外包含 SEQUENCE 和 COMMENT 语句
✅ 脚本执行完成提示（验证命令、注意事项）

输出规范：

所有 SQL 必须在同一个代码块中（sql ... ）
脚本必须可以一键复制粘贴执行
多表创建时，按照依赖关系排序（主表在前，从表在后）
必须包含完整的注释说明，便于后续维护

执行后的反馈模板

完成 SQL 脚本生成后，必须向用户提供以下完整反馈：

✅ SQL 脚本生成完成

脚本信息：

功能模块：订单管理模块
包含表数：2 个表（bus_order、bus_order_item）
数据库类型：MySQL 5.7+
脚本行数：约 80 行

表结构统计：

表名	中文名	字段数	索引数
bus_order	业务订单表	10 个业务字段 + 6 个审计字段	1 主键 + 1 唯一 + 2 普通
bus_order_item	订单明细表	8 个业务字段 + 6 个审计字段	1 主键 + 2 普通

脚本文件建议路径：

项目根目录/script/sql/business/order_management_ddl.sql

下一步操作指南：

步骤1：保存脚本文件

bash

# 创建业务 SQL 目录（如果不存在）
mkdir -p script/sql/business

# 将上述 SQL 保存为文件
vim script/sql/business/order_management_ddl.sql

步骤2：在开发环境执行脚本

方式1（命令行）：

bash

mysql -u root -p ry-vue-plus < script/sql/business/order_management_ddl.sql

方式2（Navicat/DBeaver）：
1. 打开 SQL 文件
2. 选中全部内容
3. 点击"运行"按钮执行

步骤3：验证表结构

sql

-- 验证表是否创建成功
SHOW TABLES LIKE 'bus_order%';

-- 查看表结构
DESC bus_order;
DESC bus_order_item;

-- 验证索引是否正确
SHOW INDEX FROM bus_order;

步骤4：使用代码生成器（可选）

访问代码生成器页面：http://localhost:8080/tool/gen
导入 bus_order 和 bus_order_item 表
配置生成选项后，生成对应的 Java 代码

注意事项：

⚠️ 请勿在生产环境直接执行，必须先在开发/测试环境验证
⚠️ 如果表已存在，DROP TABLE 语句会删除原表数据，请提前备份
⚠️ 执行前确认数据库名称是否正确（脚本中的 USE ry-vue-plus）
⚠️ 执行后建议提交 SQL 脚本到版本控制系统（Git）

版本控制建议：

bash

# 将 SQL 脚本纳入 Git 管理
git add script/sql/business/order_management_ddl.sql
git commit -m "feat: 添加订单管理模块数据库表结构"

Maintainer

majiayu000 Core maintainer

Source details

Full Name: majiayu000/claude-skill-registry
Branch: main
Path in repo: skills/other/database-ops
License: MIT License

Featured Tools

Join Our Newsletter

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31

Explore

Didn't find tool you were looking for?

Search AI Tools

Install this agent skill to your Project

SKILL.md

Database-Ops 数据库设计

技能说明

触发条件

必须触发的场景（强制）

应主动触发的场景（建议）

执行流程

核心规范

规范1：强制包含标准审计字段 [MANDATORY]

规范2：遵循命名与存储规范 [MANDATORY]

规范3：禁止使用物理外键 [MANDATORY]

规范4：根据数据库类型生成对应 SQL [MANDATORY]

规范5：系统表初始化检查 [MANDATORY]

禁止事项 [CRITICAL]

数据库设计层面

字段定义层面

索引设计层面

操作流程层面

安全与性能层面

参考代码资源

框架核心文件

数据类型参考

MySQL 常用类型

Oracle 常用类型

检查清单（执行前必查）

结构完整性检查

命名规范检查

存储配置检查

约束与索引检查

字段类型检查

注释完整性检查

环境适配检查

常见问题与解决方案

Q1：为什么必须使用 bigint(20) 而不是 int？

Q2：为什么禁止使用物理外键？

Q3：如何处理已存在的表需要新增字段的情况？

Q4：如何处理多租户场景的表设计？

Q5：表名超过 MySQL 64 字符限制怎么办？

输出格式要求（⭐ 关键）

核心原则：必须输出完整可执行的 SQL 脚本文件

标准 SQL 脚本文件格式（MySQL）

标准 SQL 脚本文件格式（Oracle）

输出要求总结

执行后的反馈模板

Recommended Agent Skills

agent-ops-spec

agent-ops-state

agent-ops-spec

agent-ops-testing

agent-ops-testing

agent-ops-state