Hibernate zum Herstellen einer Verbindung zu Spanner Omni verwenden

Hibernate ORM ist ein Tool für die objektrelationale Zuordnung (ORM) für die Programmiersprache Java. Es bietet ein Framework für die Zuordnung eines objektorientierten Domänenmodells zu einer relationalen Datenbank. Sie können Datenbanken mit GoogleSQL-Dialekt mit Hibernate integrieren. Verwenden Sie dazu den Open-Source-Spanner-Dialekt (SpannerDialect).

In diesem Dokument wird beschrieben, wie Sie Hibernate für die Verbindung zu Spanner Omni konfigurieren. Hibernate wird in Spanner Omni auf dieselbe Weise wie in Spanner eingebunden. Spanner ist mit Hibernate ORM 6.x kompatibel. Der Spanner-Dialekt generiert SQL-, DML- und DDL-Anweisungen für die meisten gängigen Entitätstypen und Beziehungen mithilfe von Standard-Hibernate- und Java Persistence-Annotationen.

Wenn Sie Hibernate mit Spanner Omni verwenden, können Sie Ihre vorhandenen Hibernate-Kenntnisse nutzen, um mit Ihren Datenbanken zu interagieren. Weitere Informationen finden Sie in der Spanner-Dokumentation unter Spanner mit Hibernate ORM (Spanner-Dialekt) einbinden.

Vorbereitung

Wenn Sie Hibernate mit Spanner Omni verwenden möchten, fügen Sie die folgenden Maven-Abhängigkeiten in Ihr Projekt ein:

  • Spanner Hibernate-Dialekt: Fügen Sie der Datei pom.xml Folgendes hinzu. Verwenden Sie Version 4.3.0 oder höher.

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

  • Cloud Spanner-JDBC-Treiber: Fügen Sie der Datei pom.xml Folgendes hinzu. Verwenden Sie Version 2.41.0 oder höher.

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

Ruhezustand konfigurieren

Konfigurieren Sie die SpannerDialect- und Spanner-Treiberklasse in der Datei hibernate.properties mit den Standardkonventionen für Hibernate-Dialekte:

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

Ersetzen Sie Folgendes:

  • ENDPOINT: Der Endpunkt Ihrer Spanner Omni-Instanz, z. B. localhost:15000.

  • DATABASE_ID: die ID Ihrer Spanner Omni-Datenbank, z. B. test-db.

Aktualisieren Sie hibernate.connection.url, um mit Ihrer Sicherheitskonfiguration eine Spanner Omni-Verbindung herzustellen. Weitere Informationen finden Sie unter Spanner Omni-Verbindung herstellen. Fügen Sie für verschlüsselte Verbindungstypen (TLS, TLS mit Anmeldedaten und mTLS) das CA-Zertifikat dem Java-Truststore hinzu. Weitere Informationen finden Sie unter Java-Truststore konfigurieren.