Utiliser Hibernate pour se connecter à Spanner Omni

Aperçu

Ce produit ou cette fonctionnalité est une offre en avant-première soumise aux "Conditions des offres de pré-DG" de la section Conditions générales du service des conditions spécifiques au service. Il ne peut être utilisé qu'à des fins de développement, de test, de prototypage et de démonstration de logiciels. Il ne peut pas être utilisé à des fins de traitement des données ni à des fins commerciales. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent présenter une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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 de 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'il s'intègre à 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 avec les 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 le code suivant à votre fichier pom.xml. Utilisez la version 4.2.1 ou ultérieure.

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

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

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

Remarque : La compatibilité formelle d'Hibernate ORM avec Spanner Omni est assurée par le pilote JDBC Spanner Open Source.

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

Mettez à jour hibernate.connection.url pour le protocole de connexion spécifique (texte brut, TLS ou mTLS) utilisé par votre instance Spanner Omni. Pour en savoir plus, consultez Établir une connexion Spanner Omni. Pour les modes sécurisés, ajoutez le certificat de l'autorité de certification au truststore Java ou transmettez-le directement lorsque vous exécutez l'application, comme décrit dans les instructions TLS du SDK Java.