f9f57e9505
Legacy instances created the settings table via ent auto-migration, which emits Go-level defaults only. Migration 005 uses CREATE TABLE IF NOT EXISTS, so the missing SQL DEFAULT was never backfilled. This caused 098's raw INSERT to fail with a NOT NULL violation on updated_at. The new migration is idempotent and safe for fresh installs (no-op) and historical instances (backfills the default).
28 lines
1.5 KiB
SQL
28 lines
1.5 KiB
SQL
-- 097_fix_settings_updated_at_default.sql
|
||
--
|
||
-- 修复 settings.updated_at 列在历史实例上可能缺失 SQL DEFAULT 的问题。
|
||
--
|
||
-- 背景：
|
||
-- 早期版本曾依赖 ent 自动迁移建表（ent 的 Default(time.Now) 仅是 Go 层默认值，
|
||
-- 不会在 SQL 层落地为 DEFAULT），随后引入的 005_schema_parity.sql 使用了
|
||
-- CREATE TABLE IF NOT EXISTS，对已存在的 settings 表不会重建，导致这部分实例
|
||
-- 的 updated_at 列虽然是 NOT NULL，但缺少 SQL DEFAULT。
|
||
--
|
||
-- 后续 098_migrate_purchase_subscription_to_custom_menu.sql 是项目中唯一使用
|
||
-- 原生 SQL INSERT INTO settings 的迁移（其余 settings 写入都走 ent / Go 层），
|
||
-- 因此该 schema 缺陷直到 098 才会触发：
|
||
-- "null value in column \"updated_at\" of relation \"settings\" violates not-null constraint"
|
||
--
|
||
-- 幂等性：
|
||
-- - ALTER COLUMN ... SET DEFAULT NOW() 在已经具备相同默认值的实例上是无操作，
|
||
-- 不会报错（PostgreSQL 允许重复设置相同的默认值）。
|
||
-- - UPDATE 子句的 WHERE updated_at IS NULL 在健康实例上匹配 0 行，不影响数据。
|
||
--
|
||
-- 这样可以同时兼容：
|
||
-- 1. 从未运行过旧版迁移的全新部署（005 已经把列建对，本迁移变成 no-op）。
|
||
-- 2. 历史损坏实例（本迁移修复缺失的默认值，使后续 098 能够正常 INSERT）。
|
||
|
||
ALTER TABLE settings ALTER COLUMN updated_at SET DEFAULT NOW();
|
||
|
||
UPDATE settings SET updated_at = NOW() WHERE updated_at IS NULL;
|