Implement reversible compatibi…

# PostgreSQL 14 users 表拆分迁移方案

一、迁移目标

• users 只保留登录核心字段（如 id、username、password_hash、status、created_at）
• user_profiles 存放资料字段（如 nickname、avatar、phone、bio 等）
• 120 万行数据零丢失、可回滚

二、迁移脚本（升级）

```sql

BEGIN;

-- 1. 锁表防写入（业务低峰执行，锁窗口应控制在秒级）

LOCK TABLE users IN EXCLUSIVE MODE;

-- 2. 创建新表（字段按你的实际 schema 调整）

CREATE TABLE user_profiles (

user_id BIGINT PRIMARY KEY REFERENCES users(id) ON DELETE CASCADE,

nickname VARCHAR(100),

avatar_url VARCHAR(500),

phone VARCHAR(20),

bio TEXT,

updated_at TIMESTAMPTZ DEFAULT now()

);

-- 3. 从旧表剥离资料字段

-- 先在 users 上新增列保留旧值，删除操作放在最后

CREATE TEMP TABLE tmp_users_backup AS

SELECT id, nickname, avatar_url, phone, bio FROM users; -- 全量备份兜底

ALTER TABLE users

RENAME TO users_old; -- 原表整体改名，不删数据

-- 4. 用旧表数据重建两张新表

CREATE TABLE users AS

SELECT id, username, password_hash, status, created_at

FROM users_old;

ALTER TABLE users ADD PRIMARY KEY (id);

INSERT INTO user_profiles (user_id, nickname, avatar_url, phone, bio)

SELECT id, nickname, avatar_url, phone, bio FROM users_old;

CREATE INDEX idx_user_profiles_phone ON user_profiles(phone);

-- 5. 兼容层：视图让旧 SQL 不报错（可选，过渡期用）

CREATE VIEW users_full AS

SELECT u.*, p.nickname, p.avatar_url, p.phone, p.bio

FROM users u LEFT JOIN user_profiles p ON p.user_id = u.id;

COMMIT;

```

三、回滚脚本

```sql

BEGIN;

DROP VIEW IF EXISTS users_full;

DROP TABLE IF EXISTS user_profiles;

DROP TABLE IF EXISTS users;

ALTER TABLE users_old RENAME TO users;

COMMIT;

```

四、关键保障点

• 不丢数据：users_old 整表保留 + tmp_users_backup 双保险，确认稳定后再归档删除
• **可回滚*