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 方言)」。
必要條件
如要搭配使用 Hibernate 和 Spanner Omni,請在專案中加入下列 Maven 依附元件:
Spanner Hibernate 方言:在
pom.xml檔案中新增下列內容。使用4.2.1 以上版本。<dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-spanner-hibernate-dialect</artifactId> <version>4.2.1</version> </dependency>Spanner JDBC 驅動程式:將以下內容新增至
pom.xml檔案。使用2.35.0 以上版本。<dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-spanner-jdbc</artifactId> <version>2.35.0</version> </dependency>
設定休眠
使用標準 Hibernate 方言慣例,在 hibernate.properties 檔案中設定 SpannerDialect 和 Spanner 驅動程式類別:
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?isExperimentalHost=true
更新 Spanner Omni 執行個體使用的特定連線通訊協定 (純文字、TLS 或 mTLS) 的 hibernate.connection.url。詳情請參閱「建立 Spanner Omni 連線」。如要使用安全模式,請將 CA 憑證新增至 Java 信任儲存區,或在執行應用程式時直接傳遞憑證,詳情請參閱 Java SDK TLS 指示。