Utilizzare Hibernate per connettersi a Spanner Omni

Hibernate ORM è uno strumento di mapping object-relational (ORM) per il linguaggio di programmazione Java. Fornisce un framework per mappare un modello di dominio orientato agli oggetti a un database relazionale. Puoi integrare i database con dialetto GoogleSQL con Hibernate utilizzando il dialetto Spanner open source (SpannerDialect).

Questo documento descrive come configurare Hibernate per la connessione a Spanner Omni. Hibernate si integra con Spanner Omni nello stesso modo in cui si integra con Spanner. Spanner è compatibile con Hibernate ORM 6.x. Il dialetto Spanner produce istruzioni SQL, DML e DDL per i tipi di entità e le relazioni più comuni utilizzando le annotazioni standard di Hibernate e Java Persistence.

L'utilizzo di Hibernate con Spanner Omni ti consente di utilizzare la tua esperienza Hibernate esistente per interagire con i tuoi database. Per saperne di più, consulta Integrare Spanner con Hibernate ORM (dialetto Spanner) nella documentazione di Spanner.

Prerequisiti

Per utilizzare Hibernate con Spanner Omni, includi le seguenti dipendenze Maven nel tuo progetto:

  • Dialetto Hibernate di Spanner: aggiungi quanto segue al file pom.xml. Utilizza la versione 4.3.0 o successive.

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

  • Driver JDBC di Spanner: aggiungi quanto segue al file pom.xml. Utilizza la versione 2.41.0 o successive.

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

Configura l'ibernazione

Configura la classe SpannerDialect e il driver Spanner nel file hibernate.properties utilizzando le convenzioni standard del dialetto Hibernate:

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

Sostituisci quanto segue:

  • ENDPOINT: l'endpoint dell'istanza Spanner Omni, ad esempio localhost:15000.

  • DATABASE_ID: l'ID del tuo database Spanner Omni, ad esempio test-db.

Aggiorna hibernate.connection.url per stabilire una connessione Spanner Omni utilizzando la configurazione di sicurezza. Per saperne di più, consulta Stabilisci una connessione Spanner Omni. Per i tipi di connessione criptata (TLS, TLS con credenziali e mTLS), aggiungi il certificato CA all'archivio attendibile Java. Per saperne di più, consulta Configura il truststore Java.