Utilizzare Hibernate per connettersi a Spanner Omni

Anteprima

Questo prodotto o funzionalità è un'offerta in anteprima soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi e può essere utilizzato solo per lo sviluppo, il test, la prototipazione e la dimostrazione di programmi software. Non può essere utilizzato per scopi commerciali o di trattamento dei dati. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

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.2.1 o successive.

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

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

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

Nota: il supporto formale per Hibernate ORM con Spanner Omni è fornito tramite il driver JDBC Spanner open source.

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

Aggiorna hibernate.connection.url per il protocollo di connessione specifico (testo normale, TLS o mTLS) utilizzato dall'istanza Spanner Omni. Per saperne di più, consulta Stabilire una connessione Spanner Omni. Per le modalità sicure, aggiungi il certificato CA al truststore Java o passalo direttamente quando esegui l'applicazione, come descritto nelle istruzioni TLS dell'SDK Java.