Hibernate/JPA：如何通过配置为不同实体设置不同Catalog？

完全可以通过编程方式实现和@Table注解指定catalog相同的效果，下面是两种实用的方案：

方案一：自定义PhysicalNamingStrategy（推荐） #

通过自定义物理命名策略，你可以根据表名或实体类名映射对应的catalog，这种方式能统一管理所有实体的catalog配置，避免硬编码在注解里。

步骤1：实现自定义命名策略 #

public class ConfigurableCatalogNamingStrategy extends PhysicalNamingStrategyStandardImpl {
    private final Map<String, String> tableCatalogMap;

    // 构造方法传入表名与catalog的映射关系
    public ConfigurableCatalogNamingStrategy(Map<String, String> tableCatalogMap) {
        this.tableCatalogMap = tableCatalogMap;
    }

    @Override
    public Identifier toPhysicalCatalogName(Identifier name, JdbcEnvironment jdbcEnvironment) {
        // 如果当前表名在映射配置中存在，返回对应的catalog
        if (name != null && tableCatalogMap.containsKey(name.getText())) {
            return Identifier.toIdentifier(tableCatalogMap.get(name.getText()));
        }
        // 否则使用默认逻辑
        return super.toPhysicalCatalogName(name, jdbcEnvironment);
    }
}

步骤2：配置Hibernate使用该策略 #

如果是Spring Boot环境，可通过Bean注入：

@Configuration
public class HibernateConfig {
    @Bean
    public PhysicalNamingStrategy physicalNamingStrategy() {
        Map<String, String> catalogMapping = new HashMap<>();
        // 配置表名对应的catalog
        catalogMapping.put("customer", "cat1");
        catalogMapping.put("vip_customer", "cat2");
        return new ConfigurableCatalogNamingStrategy(catalogMapping);
    }
}

如果是原生Hibernate环境：

// 构建ServiceRegistry
StandardServiceRegistry serviceRegistry = new StandardServiceRegistryBuilder()
        .configure() // 加载hibernate.cfg.xml
        .build();

// 配置命名策略
Map<String, String> catalogMapping = new HashMap<>();
catalogMapping.put("customer", "cat1");
catalogMapping.put("vip_customer", "cat2");

Configuration configuration = new Configuration();
configuration.setPhysicalNamingStrategy(new ConfigurableCatalogNamingStrategy(catalogMapping));

// 构建SessionFactory
SessionFactory sessionFactory = configuration.buildSessionFactory(serviceRegistry);

方案二：通过MetadataBuilder手动设置实体Catalog #

这种方式更灵活，可以直接针对每个实体类的表设置catalog，适合需要精细控制的场景。

// 构建ServiceRegistry
StandardServiceRegistry serviceRegistry = new StandardServiceRegistryBuilder()
        .configure()
        .build();

// 注册实体类
MetadataSources metadataSources = new MetadataSources(serviceRegistry);
metadataSources.addAnnotatedClass(Customer.class);
metadataSources.addAnnotatedClass(VipCustomer.class);

// 构建Metadata并设置catalog
Metadata metadata = metadataSources.getMetadataBuilder().build();
for (PersistentClass persistentClass : metadata.getEntityBindings()) {
    // 根据实体类名判断
    if (Customer.class.getName().equals(persistentClass.getEntityName())) {
        persistentClass.getTable().setCatalog("cat1");
    } else if (VipCustomer.class.getName().equals(persistentClass.getEntityName())) {
        persistentClass.getTable().setCatalog("cat2");
    }
}

// 基于配置好的Metadata创建SessionFactory
SessionFactory sessionFactory = metadata.buildSessionFactory();

注意事项 #

• 如果你的实体表名和类名不一致（比如用了@Table(name="xxx")），方案一中的映射要以实际表名为key；
• 方案二可以结合配置文件（比如properties/yaml）来加载实体与catalog的映射，进一步实现配置化；
• 两种方案都能完全替代@Table(catalog="xxx")的效果，Hibernate在生成SQL时会自动带上对应的catalog。

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