已将业务时间生成入口统一为 Asia/Shanghai,不依赖服务器默认时区
This commit is contained in:
+84
-9
@@ -2,7 +2,7 @@
|
||||
|
||||
以下 SQL 由维护人员手工执行,应用不会自动迁库。已有数据库执行下面的增量 SQL;新建数据库先执行 database.md 中的四表 SQL,然后只创建本文件的任务表,不重复执行 ALTER。
|
||||
|
||||
执行前暂停社区端、后台和导入工具的写入并备份数据库。不要对已有列重复执行。所有时间字段由应用写入 UTC。项目来源改为从任务表读取,因此社区端、后台和导入工具升级前都应创建任务表,即使暂不启动后台也需要执行。
|
||||
执行前暂停社区端、后台和导入工具的写入并备份数据库。不要对已有列重复执行。所有时间字段由应用写入上海时间(Asia/Shanghai,UTC+8)。项目来源改为从任务表读取,因此社区端、后台和导入工具升级前都应创建任务表,即使暂不启动后台也需要执行。
|
||||
|
||||
## 项目字段收敛
|
||||
|
||||
@@ -69,10 +69,10 @@ CREATE TABLE project_import_task (
|
||||
target_sha VARCHAR(64) NULL COMMENT '迁移后冻结的目标提交SHA',
|
||||
error_code VARCHAR(64) NULL COMMENT '最近失败错误码',
|
||||
warnings_json TEXT NOT NULL COMMENT '兼容性提醒JSON数组',
|
||||
started_at DATETIME(3) NULL COMMENT '最近开始时间UTC',
|
||||
finished_at DATETIME(3) NULL COMMENT '最近结束时间UTC',
|
||||
created_at DATETIME(3) NOT NULL COMMENT '创建时间UTC',
|
||||
updated_at DATETIME(3) NOT NULL COMMENT '更新时间UTC',
|
||||
started_at DATETIME(3) NULL COMMENT '最近开始时间(Asia/Shanghai)',
|
||||
finished_at DATETIME(3) NULL COMMENT '最近结束时间(Asia/Shanghai)',
|
||||
created_at DATETIME(3) NOT NULL COMMENT '创建时间(Asia/Shanghai)',
|
||||
updated_at DATETIME(3) NOT NULL COMMENT '更新时间(Asia/Shanghai)',
|
||||
PRIMARY KEY (id),
|
||||
UNIQUE KEY uk_import_task_code (task_code),
|
||||
UNIQUE KEY uk_import_project (project_code),
|
||||
@@ -120,7 +120,7 @@ ALTER TABLE project MODIFY COLUMN publish_status VARCHAR(16) NOT NULL DEFAULT 'U
|
||||
|
||||
## 新建普通文件写入操作记录表(本次上线前执行)
|
||||
|
||||
只新增此表,不需要修改项目表。由运维手工执行;应用不自动迁库。时间全部为 UTC。
|
||||
只新增此表,不需要修改项目表。由运维手工执行;应用不自动迁库。时间全部为上海时间(Asia/Shanghai,UTC+8)。
|
||||
|
||||
```sql
|
||||
CREATE TABLE repository_write_operation (
|
||||
@@ -137,9 +137,9 @@ CREATE TABLE repository_write_operation (
|
||||
failure_status INT NULL COMMENT '明确失败时原HTTP状态码',
|
||||
last_error_code VARCHAR(64) NULL COMMENT '最近核对错误编码,不保存异常正文或凭证',
|
||||
check_count INT NOT NULL DEFAULT 0 COMMENT '后台已执行核对次数',
|
||||
next_check_at DATETIME(3) NOT NULL COMMENT '下次只读核对时间UTC',
|
||||
created_at DATETIME(3) NOT NULL COMMENT '创建时间UTC',
|
||||
updated_at DATETIME(3) NOT NULL COMMENT '最近更新时间UTC',
|
||||
next_check_at DATETIME(3) NOT NULL COMMENT '下次只读核对时间(Asia/Shanghai)',
|
||||
created_at DATETIME(3) NOT NULL COMMENT '创建时间(Asia/Shanghai)',
|
||||
updated_at DATETIME(3) NOT NULL COMMENT '最近更新时间(Asia/Shanghai)',
|
||||
PRIMARY KEY (operation_code),
|
||||
KEY idx_write_project_status (project_code, status, created_at),
|
||||
KEY idx_write_next_check (status, next_check_at)
|
||||
@@ -147,3 +147,78 @@ CREATE TABLE repository_write_operation (
|
||||
```
|
||||
|
||||
已完成的操作记录仍用于幂等重放,不要在客户端可能重试期间删除。历史 REVIEW 没有操作记录,不会凭最新 SHA 自动判成功;需核对实际结果后按原维护流程处理。迁移、Fork 继续使用原流程。
|
||||
|
||||
## 业务时间由 UTC 迁移到上海时间
|
||||
|
||||
新版统一通过 `ProjectSupport` 生成上海时间(`Asia/Shanghai`),字段类型保持 `DATETIME(3)`。以下 SQL 由维护人员手工执行,应用不会执行迁移,也不会自动修改已有数据库。
|
||||
|
||||
执行顺序:暂停社区端、管理端和导入工具,备份业务数据库及导入状态目录;确认以下六张表中的历史时间仍全部为 UTC 后执行一次转换;核对结果后同时部署新版各模块,并同步前端的 `+08:00` 解析方式,再恢复服务。新建空库无需执行数据转换。若已经写入上海时间或存在混合时区数据,必须先按切换记录确定待转换数据范围,不能直接执行以下全表更新;本脚本不能重复执行。
|
||||
|
||||
```sql
|
||||
USE vibemake;
|
||||
START TRANSACTION;
|
||||
|
||||
UPDATE sys_user
|
||||
SET created_at = DATE_ADD(created_at, INTERVAL 8 HOUR),
|
||||
updated_at = DATE_ADD(updated_at, INTERVAL 8 HOUR);
|
||||
|
||||
UPDATE project
|
||||
SET created_at = DATE_ADD(created_at, INTERVAL 8 HOUR),
|
||||
updated_at = DATE_ADD(updated_at, INTERVAL 8 HOUR),
|
||||
published_at = DATE_ADD(published_at, INTERVAL 8 HOUR);
|
||||
|
||||
UPDATE project_comment
|
||||
SET created_at = DATE_ADD(created_at, INTERVAL 8 HOUR),
|
||||
updated_at = DATE_ADD(updated_at, INTERVAL 8 HOUR);
|
||||
|
||||
UPDATE project_like
|
||||
SET created_at = DATE_ADD(created_at, INTERVAL 8 HOUR);
|
||||
|
||||
UPDATE project_import_task
|
||||
SET created_at = DATE_ADD(created_at, INTERVAL 8 HOUR),
|
||||
updated_at = DATE_ADD(updated_at, INTERVAL 8 HOUR),
|
||||
started_at = DATE_ADD(started_at, INTERVAL 8 HOUR),
|
||||
finished_at = DATE_ADD(finished_at, INTERVAL 8 HOUR);
|
||||
|
||||
UPDATE repository_write_operation
|
||||
SET created_at = DATE_ADD(created_at, INTERVAL 8 HOUR),
|
||||
updated_at = DATE_ADD(updated_at, INTERVAL 8 HOUR),
|
||||
next_check_at = DATE_ADD(next_check_at, INTERVAL 8 HOUR);
|
||||
|
||||
COMMIT;
|
||||
```
|
||||
|
||||
空值保持为空,毫秒精度保持不变。`next_check_at` 等调度时间也需要转换,避免切换后提前或延后核对任务。Git 提交日期、OSS 签名内容和 Gitea 内部数据库不参与转换。
|
||||
|
||||
已有数据库的时间字段注释可单独按以下 SQL 更新;DDL 会隐式提交,不要放入上面的数据转换事务。
|
||||
|
||||
```sql
|
||||
ALTER TABLE sys_user
|
||||
MODIFY COLUMN created_at DATETIME(3) NOT NULL COMMENT '创建时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN updated_at DATETIME(3) NOT NULL COMMENT '更新时间(Asia/Shanghai)';
|
||||
|
||||
ALTER TABLE project
|
||||
MODIFY COLUMN created_at DATETIME(3) NOT NULL COMMENT '创建时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN updated_at DATETIME(3) NOT NULL COMMENT '更新时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN published_at DATETIME(3) NULL COMMENT '最近发布时间(Asia/Shanghai)';
|
||||
|
||||
ALTER TABLE project_comment
|
||||
MODIFY COLUMN created_at DATETIME(3) NOT NULL COMMENT '创建时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN updated_at DATETIME(3) NOT NULL COMMENT '更新时间(Asia/Shanghai)';
|
||||
|
||||
ALTER TABLE project_like
|
||||
MODIFY COLUMN created_at DATETIME(3) NOT NULL COMMENT '点赞时间(Asia/Shanghai)';
|
||||
|
||||
ALTER TABLE project_import_task
|
||||
MODIFY COLUMN created_at DATETIME(3) NOT NULL COMMENT '创建时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN updated_at DATETIME(3) NOT NULL COMMENT '更新时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN started_at DATETIME(3) NULL COMMENT '最近开始时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN finished_at DATETIME(3) NULL COMMENT '最近结束时间(Asia/Shanghai)';
|
||||
|
||||
ALTER TABLE repository_write_operation
|
||||
MODIFY COLUMN created_at DATETIME(3) NOT NULL COMMENT '创建时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN updated_at DATETIME(3) NOT NULL COMMENT '最近更新时间(Asia/Shanghai)',
|
||||
MODIFY COLUMN next_check_at DATETIME(3) NOT NULL COMMENT '下次只读核对时间(Asia/Shanghai)';
|
||||
```
|
||||
|
||||
旧导入状态首次由新版读取时,将未声明时区的 `reservedAt` 从 UTC 转为上海时间,原子保存并标记 `timeZone=Asia/Shanghai`,后续不会再次转换。应在业务库完成转换后再续跑;未迁移的数据库时间与清单不一致时,现有归属校验会阻止接管项目。回滚应用前需要同时恢复数据库和导入状态备份,并恢复前端的旧时间解析约定。
|
||||
|
||||
Reference in New Issue
Block a user