使用 Hibernate 連線至 Spanner Omni

Hibernate ORM 是 Java 程式設計語言的物件關聯對應 (ORM) 工具。這個框架可將物件導向網域模型對應至關聯式資料庫。您可以使用開放原始碼的 Spanner 方言 (SpannerDialect)，將 GoogleSQL 方言資料庫與 Hibernate 整合。

本文說明如何設定 Hibernate，以便連線至 Spanner Omni。Hibernate 與 Spanner Omni 的整合方式，與 Hibernate 與 Spanner 的整合方式相同。Spanner 與 Hibernate ORM 6.x 相容。Spanner 方言會使用標準 Hibernate 和 Java Persistence 註解，為最常見的實體型別和關係產生 SQL、DML 和 DDL 陳述式。

搭配使用 Hibernate 和 Spanner Omni，即可運用現有的 Hibernate 經驗與資料庫互動。詳情請參閱 Spanner 說明文件中的「整合 Spanner 與 Hibernate ORM (Spanner 方言)」。

必要條件

如要搭配 Spanner Omni 使用 Hibernate，請在專案中加入下列 Maven 依附元件：

• Spanner Hibernate 方言：在 pom.xml 檔案中新增下列內容。使用4.3.0 以上版本。

  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-spanner-hibernate-dialect</artifactId>
    <version>4.3.0</version>
  </dependency>
  

• Spanner JDBC 驅動程式：在 pom.xml 檔案中新增下列內容。使用 2.41.0 以上版本。

  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-spanner-jdbc</artifactId>
    <version>2.41.0</version>
  </dependency>
  

注意： 透過開放原始碼的 Spanner JDBC 驅動程式，即可正式支援 Hibernate ORM 與 Spanner Omni。

設定 Hibernate

使用標準 Hibernate 方言慣例，在 SpannerDialect 和 Spanner 驅動程式類別中設定 hibernate.properties 檔案：

hibernate.dialect=com.google.cloud.spanner.hibernate.SpannerDialect
hibernate.connection.driver_class=com.google.cloud.spanner.jdbc.JdbcDriver
hibernate.connection.url=jdbc:spanner://ENDPOINT/databases/DATABASE_ID?type=omni

更改下列內容：

• ENDPOINT：Spanner Omni 執行個體的端點，例如 localhost:15000。

• DATABASE_ID：Spanner Omni 資料庫的 ID，例如 test-db。

更新 hibernate.connection.url，使用安全性設定建立 Spanner Omni 連線。詳情請參閱「建立 Spanner Omni 連線」。如果是加密連線類型 (TLS、TLS (含憑證) 和 mTLS)，請將 CA 憑證新增至 Java 信任儲存庫。詳情請參閱「設定 Java 信任儲存庫」。