将 Spanner 与 Hibernate ORM 集成（GoogleSQL 方言）

Hibernate 是适用于 Java 编程语言的对象关系映射工具。它提供了一个框架，用于将面向对象的网域模型映射到关系型数据库。

您可以使用开源 Spanner 方言 (SpannerDialect) 将 GoogleSQL 方言数据库与 Hibernate 集成。Spanner 与 Hibernate ORM 6.x 兼容。Spanner 方言使用标准 Hibernate 和 Java Persistence 注解为大多数常见实体类型和关系生成 SQL、DML 和 DDL 语句。

设置 Hibernate

在项目中，为 Hibernate ORM 核心、Spanner 方言和 Spanner 官方支持的开源 JDBC 驱动程序添加 Apache Maven 依赖项。

<dependencies>
  <!-- The Spanner JDBC driver dependency -->
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-spanner-jdbc</artifactId>
  </dependency>

  <!-- Hibernate core dependency -->
  <dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.4.4.Final</version>
  </dependency>
</dependencies>

配置 hibernate.cfg.xml 以使用 Spanner 方言和 Spanner JDBC 驱动程序。

<!-- Connection settings -->
<property name="hibernate.dialect">org.hibernate.dialect.SpannerDialect</property>
<property name="hibernate.connection.driver_class">com.google.cloud.spanner.jdbc.JdbcDriver</property>
<property name="hibernate.connection.url">jdbc:cloudspanner:/projects/{YOUR_PROJECT_ID}/instances/{YOUR_INSTANCE_ID}/databases/{YOUR_DATABASE_ID}</property>

服务账号 JSON 凭据文件位置应位于 GOOGLE_APPLICATION_CREDENTIALS 环境变量中。否则，该驱动程序将使用在 Google Cloud CLI gcloud 应用中设置的默认凭据。

将 Hibernate 与 Spanner GoogleSQL 搭配使用

如需详细了解 Hibernate 的相关功能和建议，请参阅 GitHub 上的参考文档。

后续步骤

• 查看将 Hibernate 与 Spanner 搭配使用的代码示例。
• 结合试用 Spanner 和 Hibernate ORM codelab。
• 详细了解 Hibernate ORM。
• 在 GitHub 上查看 Spanner 方言的代码库。
• 提交 GitHub 问题以报告 bug 或提出有关 Hibernate 的问题。
• 详细了解 Apache Maven。
• 详细了解如何将 Spanner 与 Hibernate ORM 集成（PostgreSQL 方言）。