Utiliser Hibernate pour se connecter à Spanner Omni

Hibernate ORM est un outil de mappage objet-relationnel (ORM) pour le langage de programmation Java. Il fournit un framework permettant de mapper un modèle de domaine orienté objet à une base de données relationnelle. Vous pouvez intégrer des bases de données utilisant le dialecte GoogleSQL à Hibernate à l'aide du dialecte Spanner Open Source (SpannerDialect).

Ce document explique comment configurer Hibernate pour se connecter à Spanner Omni. Hibernate s'intègre à Spanner Omni de la même manière qu'à Spanner. Spanner est compatible avec Hibernate ORM 6.x. Le dialecte Spanner génère des instructions SQL, LMD et LDD pour la plupart des types d'entités et des relations courantes à l'aide d'annotations Hibernate et Java Persistence standards.

L'utilisation d'Hibernate avec Spanner Omni vous permet d'utiliser votre expérience Hibernate existante pour interagir avec vos bases de données. Pour en savoir plus, consultez Intégrer Spanner à Hibernate ORM (dialecte Spanner) dans la documentation Spanner.

Prérequis

Pour utiliser Hibernate avec Spanner Omni, incluez les dépendances Maven suivantes dans votre projet :

  • Dialecte Hibernate Spanner : ajoutez ce qui suit à votre fichier pom.xml. Utilisez la version 4.3.0 ou une version ultérieure.

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

  • Pilote Spanner JDBC : ajoutez les éléments suivants à votre fichier pom.xml. Utilisez la version 2.41.0 ou une version ultérieure.

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

Configurer Hibernate

Configurez la classe de pilote SpannerDialect et Spanner dans le fichier hibernate.properties à l'aide des conventions de dialecte Hibernate standards :

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

Remplacez les éléments suivants :

  • ENDPOINT : point de terminaison de votre instance Spanner Omni, par exemple localhost:15000.

  • DATABASE_ID : ID de votre base de données Spanner Omni, par exemple test-db.

Mettez à jour hibernate.connection.url pour établir une connexion Spanner Omni à l'aide de votre configuration de sécurité. Pour en savoir plus, consultez Établir une connexion Spanner Omni. Pour les types de connexion chiffrés (TLS, TLS avec identifiants et mTLS), ajoutez le certificat CA au truststore Java. Pour en savoir plus, consultez Configurer le truststore Java.