Skip to content

数据库初始化 ​

砚考按业务边界拆了 5 个库。不要把它们的表塞进同一个库——动态数据源靠库名区分,混在一起会导致跨服务关联失效。

库清单 ​

数据库名用途使用者
ry-cloud系统基础库(用户/角色/菜单/字典/租户/AI 模型配置)system、gen、resource
ry-configNacos 配置库Nacos 服务端
ry-exam考试主库question、paper、manage、mark、stat、practice、cert、proctor、ai
ry-exam-answer答卷/成绩库answer(独立库,便于后续分库分表)
ry-jobSnailJob 定时任务库job、snailjob-server
ry-workflow工作流库workflow
ry-seataSeata 事务库seata-server(可选)

脚本位置 ​

所有脚本在 exam-back/script/sql/ 下。

脚本大小说明
ry-cloud.sql771 KB系统基础库建表 + 菜单/字典/用户/租户种子数据
ry-config.sql250 KBNacos 配置库 dump(有坑,见下方警告)
ry-exam.sql62 KB考试主库 29 张表 + 种子数据
ry-exam-answer.sql4.8 KB答卷库 2 张表
ry-job.sql37 KBSnailJob 服务端库
ry-workflow.sql18 KBwarm-flow 工作流库
ry-seata.sql3 KBSeata 服务端库
sql/oracle/、sql/postgres/—异构数据库版本的 ry-cloud 脚本
sql/update/—增量脚本目录

执行顺序 ​

bash
mysql -uroot -p -e "CREATE DATABASE IF NOT EXISTS \`ry-cloud\` DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;"
mysql -uroot -p -e "CREATE DATABASE IF NOT EXISTS \`ry-config\` DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;"
mysql -uroot -p -e "CREATE DATABASE IF NOT EXISTS \`ry-exam\` DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;"
mysql -uroot -p -e "CREATE DATABASE IF NOT EXISTS \`ry-exam-answer\` DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;"

# 1) Nacos 配置库
mysql -uroot -p ry-config < script/sql/ry-config.sql

# 2) 系统基础库
mysql -uroot -p ry-cloud  < script/sql/ry-cloud.sql

# 3) 考试主库  ← 核心
mysql -uroot -p ry-exam   < script/sql/ry-exam.sql

# 4) 答卷库
mysql -uroot -p ry-exam-answer < script/sql/ry-exam-answer.sql

# 5) 可选
mysql -uroot -p ry-job      < script/sql/ry-job.sql
mysql -uroot -p ry-workflow < script/sql/ry-workflow.sql
mysql -uroot -p ry-seata    < script/sql/ry-seata.sql

ry-config.sql 含有多份历史脏数据

ry-config.sql 是 Nacos 配置表的 dump,datasource.yml 在里面有多份历史版本:

  • 出现过 8.137.151.232:3306、host.docker.internal:3306、localhost:3306 三种 MySQL 地址
  • 密码混杂着 password 与 ruoyi123
  • 甚至有一条把键名错写成 ruoyi123: ruoyi123

直接导入,最终生效的是最后一条记录,很容易连不上库。

推荐做法:跳过这个 dump,改从 Nacos 配置导入 手工录入,干净且可控。

考试主库表清单(29 张) ​

业务域表名说明
考试管理exam考试主表
exam_invite考试邀请(公开链接)记录
exam_user白名单考生
题库question题目主表
question_option题目选项
question_bank题库
question_bank_category题库分类树
试卷paper试卷
paper_question试卷-题目关联
阅卷exam_mark_task阅卷任务
exam_mark_item阅卷明细(逐题)
exam_mark_log改分审计日志
证书exam_certificate证书模板
exam_certificate_record证书颁发记录
防作弊exam_proctor_session监考会话
exam_proctor_event防作弊事件流水
exam_proctor_snapshot摄像头抓拍
错题本wrong_question错题
wrong_review_record错题重做记录
统计stat_exam_summary考试汇总(预计算)
stat_exam_score_segment分数段分布
stat_exam_user考生明细
stat_exam_question题目正确率/难度/区分度
stat_exam_question_option选项分布与易错项
stat_exam_knowledge知识点掌握度
stat_calc_task重算任务
stat_export_task导出任务

答卷库表清单(2 张) ​

表名说明
exam_record答卷记录(含成绩、用时、状态)
exam_answer逐题作答明细

为什么答卷要独立成库

答题是唯一的高并发写场景——一场考试几千人同时交卷。 把 exam_answer 单独放一个库,后续可以直接对它在 ShardingSphere 里按 exam_id 分片,而不影响其它业务库。

增量脚本 ​

script/sql/update/ 下有两种脚本:

① 框架版本升级(按版本顺序执行)

text
update_2.0-2.1.sql
update_2.1.0-2.1.1.sql
...
update_2.5.3_2.6.0.sql

② 考试域增量(幂等,可重复执行)

脚本作用
update_exam_dict.sql把前端写死的状态/类型收敛为 RuoYi 字典(exam_*、question_*、bank_*、code_languages 等)
update_exam_exam_type.sqlexam 增加 exam_type(1 正式 / 2 练习),放开起止时间非空约束
update_exam_stat.sql增加 partial_score、partial_score_rate;建统计表
update_exam_cert.sql增加 cert_id(绑定的证书模板,为空不发)
update_exam_white_user.sql白名单考生
update_exam_wrong_question_tenant.sql错题表补租户字段
update_exam_mark_menu.sql阅卷菜单(menu_id 2101-2102,权限 exam:mark:*)
update_exam_proctor_menu.sql监考中心菜单(2103-2104,权限 exam:proctor:*)
update_exam_stat_menu.sql统计菜单(权限 exam:stat:*)
update_exam_cert_menu.sql证书管理菜单(2106-2107,权限 exam:cert:*)
bash
mysql -uroot -p ry-exam < script/sql/update/update_exam_dict.sql
mysql -uroot -p ry-exam < script/sql/update/update_exam_stat.sql
# ...依次执行

菜单脚本可跳过

菜单类脚本(*_menu.sql)用 INSERT ... SELECT ... WHERE NOT EXISTS 幂等写法,也可以在后台 系统管理 → 菜单管理 里手工添加,更直观。

数据源配置 ​

Nacos 的 datasource.yml 里定义了别名,各服务的 yml 通过 ${datasource.xxx.url} 引用:

别名指向库
system-masterry-cloud
genry-cloud
jobry-job
workflowry-workflow
examry-exam
exam-answerry-exam-answer

只需改 datasource.yml 一处,10 个考试服务全部生效。详见 Nacos 配置导入。

下一步 ​

数据库就绪后,导入 Nacos 配置。

砚考 · 让每一次考试都经得起检验