如何批量将整数ID主键替换为UUID并同步更新所有外键关联关系

首先明确：不存在通用的单条SQL语句可以完成全量自动同步更新，这类操作同时涉及主键约束切换、外键约束变更、跨表数据映射，属于DDL+DML混合的批量操作，所有关系型数据库都不支持单语句完成这类跨多表的元数据+数据修改。不过你可以通过动态SQL脚本实现半自动化操作，不用逐个手动处理关联表，大幅减少繁琐工作量。

具体实现步骤（以PostgreSQL为例，MySQL可替换对应系统表查询、函数和动态SQL语法） #

1. 先查询所有关联外键的元数据（避免手动找表漏项） #

SELECT 
    tc.table_name AS foreign_table,
    kcu.column_name AS foreign_key_column,
    tc.constraint_name AS fk_constraint_name
FROM 
    information_schema.table_constraints tc
JOIN 
    information_schema.key_column_usage kcu 
ON tc.constraint_name = kcu.constraint_name
WHERE 
    tc.constraint_type = 'FOREIGN KEY' 
    AND kcu.referenced_table_name = '你的原表名';

2. 给原表新增UUID列并替换为主键 #

-- 原表新增UUID列，自动填充值
ALTER TABLE 你的原表名 ADD COLUMN uuid_key UUID DEFAULT gen_random_uuid() NOT NULL;
-- 删除原主键约束，加CASCADE会自动删除所有关联的外键约束，不用手动逐个删除
ALTER TABLE 你的原表名 DROP CONSTRAINT 你的原表名_pkey CASCADE;
-- 将UUID列设为新主键
ALTER TABLE 你的原表名 ADD PRIMARY KEY (uuid_key);

3. 动态SQL批量同步所有关联表的外键 #

直接执行下面的动态脚本，会自动遍历所有关联外键表，完成新增UUID列、数据映射填充、外键约束重建的全流程：

DO $$
DECLARE
    fk_record RECORD;
BEGIN
    FOR fk_record IN 
        -- 复用第一步的外键查询逻辑
        SELECT 
            tc.table_name AS foreign_table,
            kcu.column_name AS foreign_key_column,
            tc.constraint_name AS fk_constraint_name
        FROM 
            information_schema.table_constraints tc
        JOIN 
            information_schema.key_column_usage kcu 
        ON tc.constraint_name = kcu.constraint_name
        WHERE 
            tc.constraint_type = 'FOREIGN KEY' 
            AND kcu.referenced_table_name = '你的原表名'
    LOOP
        -- 给外键表新增UUID类型的外键列
        EXECUTE format('ALTER TABLE %I ADD COLUMN %I_uuid UUID', fk_record.foreign_table, fk_record.foreign_key_column);
        -- 通过原int外键关联主表，填充对应的UUID值
        EXECUTE format('UPDATE %I t SET %I_uuid = p.uuid_key FROM 你的原表名 p WHERE t.%I = p.原int主键列名', 
            fk_record.foreign_table, fk_record.foreign_key_column, fk_record.foreign_key_column);
        -- 可选操作：删除原int外键列，把新UUID列改名为原外键列名，兼容现有业务代码
        EXECUTE format('ALTER TABLE %I DROP COLUMN %I', fk_record.foreign_table, fk_record.foreign_key_column);
        EXECUTE format('ALTER TABLE %I RENAME COLUMN %I_uuid TO %I', 
            fk_record.foreign_table, fk_record.foreign_key_column, fk_record.foreign_key_column);
        -- 重建外键约束
        EXECUTE format('ALTER TABLE %I ADD FOREIGN KEY (%I) REFERENCES 你的原表名(uuid_key)', 
            fk_record.foreign_table, fk_record.foreign_key_column);
    END LOOP;
END $$;

4. 收尾操作（可选） #

如果不需要保留原自增int主键，可以直接删除该列；如果需要留作历史字段，设置为普通可空列即可。

注意：执行所有操作前必须全量备份数据库，建议先在测试环境完整验证执行流程和结果，再上生产环境执行。如果涉及大表，建议在业务低峰期操作，避免锁表影响业务。

内容的提问来源于stack exchange，提问作者meds