Files
coolcoth.com/install/upgrades
2026-08-08 16:26:31 +08:00
..
2026-08-08 15:53:53 +08:00
2026-08-08 15:53:53 +08:00
2026-08-08 15:53:53 +08:00
2026-08-08 16:26:31 +08:00

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
数据库升级包目录(install/upgrades
================================================

用途
----
将「升级脚本」(.sql 文件)放入本目录后,进入后台「数据库升级」页面,
系统会自动扫描并提示「发现 N 个可升级数据库脚本」,管理员可一键或逐个执行。
每次执行都会在 db_upgrades 表中留下记录(文件名、内容指纹 MD5、执行时间、操作人),
便于追溯与审计。

命名建议
--------
  序号_功能描述.sql     例如  001_add_member_level.sql
序号便于排序与阅读,文件名(不含路径)作为唯一标识写入 db_upgrades。
若同一文件内容被修改后再次放入,系统会识别为「内容已变更」并提示重新升级。

编写规范
--------
1. 仅放 DDL / DML 的标准 MySQL 脚本;多条语句以分号(;)分隔,自动拆分执行。
2. 优先使用「幂等写法」,避免重复执行报错,例如:
     CREATE TABLE IF NOT EXISTS xxx (...);
     ALTER TABLE yyy ADD COLUMN IF NOT EXISTS zzz ...;   -- MySQL 8.0.28+
     INSERT INTO ... ON DUPLICATE KEY UPDATE ...;
3. 不建议在升级包中执行 DROP TABLE / TRUNCATE 等破坏性语句,除非确有必要。
4. 升级前请务必备份数据库。

说明
----
- 本目录下的 examples/ 子目录为示例,不会被自动扫描(仅扫描本目录根下的 *.sql)。
- 想试用示例时,请将 examples/ 中的文件复制到本目录根下再执行。