如何在Quarkus的Hibernate中修改PostgreSQL使用的数据库schema

以下是三种常用的实现方式，可根据你的业务场景选择：

方法1：全局统一配置（所有表使用自定义Schema） #

直接在项目配置文件中修改Hibernate全局默认Schema，无需修改实体类代码，适合全项目表都在同一个自定义Schema下的场景。

application.properties 写法 #

# 核心配置：指定Hibernate默认使用的Schema
quarkus.hibernate-orm.database.default-schema=自定义Schema名称
# 多数据源场景下，给指定数据源配置对应Schema，示例为名为order的数据源
# quarkus.hibernate-orm."order".database.default-schema=自定义Schema名称
# 可选：启动时自动维护Schema内的表结构
quarkus.hibernate-orm.database.generation=update

application.yaml 写法 #

quarkus:
  hibernate-orm:
    database:
      default-schema: 自定义Schema名称
      # 多数据源配置示例
      # "order":
      #   database:
      #     default-schema: 自定义Schema名称
      generation: update

方法2：部分实体指定Schema #

如果只有部分表需要放在自定义Schema下，其余表保留默认public Schema，可以选择以下两种配置方式：

单个实体指定 #

使用JPA标准@Table注解的schema属性配置：

import jakarta.persistence.Entity;
import jakarta.persistence.Table;

@Entity
@Table(name = "user_info", schema = "自定义Schema名称")
public class UserInfo {
    // 实体属性定义
}

同包下实体批量指定 #

在实体所在包下创建package-info.java文件，添加Hibernate包级Schema注解，该包下所有实体自动生效：

@org.hibernate.annotations.Schema(name = "自定义Schema名称")
package com.yourproject.entity;

方法3：JDBC连接层指定默认Schema #

在PostgreSQL JDBC连接串中添加currentSchema参数，连接层面直接指定默认Schema，原生SQL查询也无需额外加Schema前缀：

quarkus.datasource.jdbc.url=jdbc:postgresql://数据库地址:端口/数据库名?currentSchema=自定义Schema名称

注意事项 #

• 配置前需提前在PostgreSQL中创建对应自定义Schema，创建SQL：CREATE SCHEMA IF NOT EXISTS 自定义Schema名称;
• 配置优先级：实体类@Table的schema属性 > Hibernate全局default-schema配置 > JDBC连接串currentSchema参数
• 若使用Flyway/Liquibase做数据库版本管理，需同步配置对应工具的默认Schema，例Flyway配置：quarkus.flyway.default-schema=自定义Schema名称

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