Integra Spanner con Hibernate ORM (dialecto de GoogleSQL)

Hibernate es una herramienta de asignación relacional de objetos para el lenguaje de programación Java. Proporciona un framework para asignar un modelo de dominio orientado a objetos a una base de datos relacional.

Puedes integrar bases de datos con dialecto de GoogleSQL en Hibernate con el dialecto de Spanner de código abierto (SpannerDialect). Spanner es compatible con Hibernate ORM 6.x. Spanner Dialect genera instrucciones de SQL, DML y DDL para la mayoría de los tipos de entidades y relaciones comunes con anotaciones estándar de Hibernate y Java Persistence.

Cómo configurar Hibernate

En tu proyecto, agrega las dependencias de Apache Maven para el núcleo de Hibernate ORM, Spanner Dialect y el controlador JDBC de código abierto compatible a nivel oficial con Spanner.

<dependencies>
  <!-- The Spanner JDBC driver dependency -->
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-spanner-jdbc</artifactId>
  </dependency>

  <!-- Hibernate core dependency -->
  <dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.4.4.Final</version>
  </dependency>
</dependencies>

Configura hibernate.cfg.xml para usar Spanner Dialect y el controlador JDBC de Spanner.

<!-- Connection settings -->
<property name="hibernate.dialect">org.hibernate.dialect.SpannerDialect</property>
<property name="hibernate.connection.driver_class">com.google.cloud.spanner.jdbc.JdbcDriver</property>
<property name="hibernate.connection.url">jdbc:cloudspanner:/projects/{YOUR_PROJECT_ID}/instances/{YOUR_INSTANCE_ID}/databases/{YOUR_DATABASE_ID}</property>

La ubicación del archivo de credenciales JSON de la cuenta de servicio debe estar en la variable de entorno GOOGLE_APPLICATION_CREDENTIALS. De lo contrario, el controlador usará las credenciales predeterminadas establecidas en la aplicación gcloud de Google Cloud CLI.

Usa Hibernate con Spanner GoogleSQL

Para obtener más información sobre las funciones y recomendaciones de Hibernate, consulta la documentación de referencia en GitHub.

¿Qué sigue?