如何在PostgreSQL正确的 使用UUID 作为主键

如何在PostgreSQL正确的 使用UUID 作为主键

UUID 经常用作数据库表主键。它们易于生成,易于在分布式系统之间共享并保证唯一性。

考虑到 UUID 的大小,这是否是一个正确的选择值得怀疑,但通常这不是由我们决定的。

本文的重点不是“UUID 是否是主键的正确格式”,而是如何有效地使用 UUID 作为 PostgreSQL 的主键。

Postgres 数据的UUID类型

UUID 可以被视为一个字符串,并且可能很容易将它们存储为字符串。 Postgres 具有用于存储字符串的灵活数据类型: text ,并且通常用作存储 UUID 值的主键。

它是正确的数据类型吗?当然不是。

Postgres 有一个专用于 UUID 的数据类型: uuid 。 UUID 是 128 位数据类型,因此存储单个值需要 16 个字节。 text 数据类型有 1 或 4 个字节的开销加上存储实际的字符串。

这些差异在小表中并不那么重要,但一旦开始存储数十万或数百万行,就会成为问题。

我进行了一个实验,看看实践中有何不同。有两个表只有一列 - id 作为主键。第一个表使用 text ,第二个表使用 uuid

create table bank_transfer(
    id text primary key
);

create table bank_transfer_uuid(
    id uuid primary key
);

我没有指定主键索引的类型,因此 Postgres 使用默认的 B 树。

然后我使用 Spring 的 JdbcTemplate 中的 batchUpdate 向每个表插入 10 000 000 行:

jdbcTemplate.batchUpdate("insert into bank_transfer (id) values (?)",
        new BatchPreparedStatementSetter() {
   
            @Override
            public void setValues(PreparedStatement ps, int i) throws SQLException {
   
                ps.setString(1, UUID.randomUUID().toString());
            }

            @Override
            public int getBatchSize() {
   
                return 10_000_000;
            }
});
jdbcTemplate.
### MyBatisPlus 使用 UUID 作为主键报错解决方案 在使用 MyBatisPlus 的 `insert` 方法时,默认情况下会生成一个 Long 类型的 UUID 并将其用作主键 ID,这可能导致与数据库中的 UUID 字段类型不匹配而引发错误[^1]。 #### 方案一:自定义 ID 生成策略 为了使 MyBatisPlus 支持 PostgreSQL 数据库中的 UUID 类型字段,在实体类中可以实现自定义的 ID 生成器。通过继承 `IdentifierGenerator` 或者覆盖默认的行为来确保生成的是标准的 Java `UUID` 对象而不是 Long 类型: ```java import com.baomidou.mybatisplus.core.incrementer.IdentifierGenerator; import java.util.UUID; public class UuidGenerator implements IdentifierGenerator { @Override public Number nextId(Object entity) { return (Number)new UUID.randomUUID().getMostSignificantBits(); } } ``` 接着配置全局设置或针对特定实体指定此生成器: ```yaml mybatis-plus: global-config: id-type: NONE # 关闭内置ID生成机制 ``` 以及在实体类上标注: ```java @TableId(type = IdType.NONE, valueGen = @TableId.Value(genClass = UuidGenerator.class)) private String id; // 注意这里应为String或其他适合存储UUID的形式 ``` #### 方案二:调整返回值处理逻辑 如果遇到插入操作之后获取不到正确返回的 UUID 主键的情况,则可能是由于驱动程序对于非整数类型的主键支持不够完善所引起的[^4]。此时可以通过手动查询刚插入记录的方式来获得新创建对象的实际主键值。 另外一种方式是在 Mapper XML 文件里显式声明 `<selectKey>` 来控制如何计算并赋给目标列的新值: ```xml <insert> INSERT INTO table_name(column_list) VALUES(value_list); <selectKey keyProperty="id" resultType="java.lang.String" order="AFTER"> SELECT CAST(uuid_in(md5(random()::text || clock_timestamp()::text)::cstring) AS VARCHAR(36)) as new_id </selectKey> </insert> ``` 以上两种方法都可以有效解决 MyBatisPlus 插入带有 UUID 类型主键的数据到 PostgreSQL 中的问题。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值