Hibernate zum Herstellen einer Verbindung zu Spanner Omni verwenden

Vorschau

Dieses Produkt oder Feature ist ein Vorschauangebot, das den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt Allgemeine Dienstbedingungen der dienstspezifischen Nutzungsbedingungen unterliegt und nur zum Entwickeln, Testen, Erstellen von Prototypen und Demonstrieren von Softwareprogrammen verwendet werden darf. Es darf nicht für die Datenverarbeitung oder kommerzielle Zwecke verwendet werden. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

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 im GoogleSQL-Dialekt mit Hibernate über den Open-Source-Spanner-Dialekt (SpannerDialect) integrieren.

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 integriert. Spanner ist mit Hibernate ORM 6.x kompatibel. Der Spanner-Dialekt erstellt SQL-, DML- und DDL-Anweisungen für die gängigsten Entitätstypen und -beziehungen. Dazu werden standardmäßige Hibernate- und Java Persistence-Anmerkungen verwendet.

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 unter Spanner mit Hibernate ORM (Spanner-Dialekt) einbinden in der Spanner-Dokumentation.

Vorbereitung

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

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

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

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

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

Hinweis: Der formale Support für Hibernate ORM mit Spanner Omni wird über den Open-Source-JDBC-Treiber für Spanner bereitgestellt.

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?isExperimentalHost=true

Aktualisieren Sie die hibernate.connection.url für das spezifische Verbindungsprotokoll (Nur-Text, TLS oder mTLS), das von Ihrer Spanner Omni-Instanz verwendet wird. Weitere Informationen finden Sie unter Spanner Omni-Verbindung herstellen. Fügen Sie für sichere Modi das CA-Zertifikat dem Java-Truststore hinzu oder übergeben Sie es direkt, wenn Sie die Anwendung ausführen, wie in der TLS-Anleitung für das Java SDK beschrieben.