Integrar o Spanner com o Spring Data JPA (dialeto GoogleSQL)

O Spring Data JPA, parte da família Spring Data maior, facilita a implementação de repositórios baseados em JPA. O Spring Data JPA é compatível com o Spanner e uma ampla variedade de outros sistemas de banco de dados. Ele adiciona uma camada de abstração entre o aplicativo e o banco de dados, facilitando a portabilidade do aplicativo de um sistema de banco de dados para outro.

Configurar o Spring Data JPA para bancos de dados de dialetos GoogleSQL do Spanner

É possível integrar bancos de dados do dialeto GoogleSQL do Spanner com o Spring Data JPA usando o dialeto Spanner Hibernate (SpannerDialect) de código aberto.

Para ver um exemplo, consulte o aplicativo de exemplo funcional completo no GitHub.

Dependências

No seu projeto, adicione dependências do Apache Maven para Spring Data JPA, Dialeto Hibernate do Spanner e o driver JDBC de código aberto do Spanner.

  <dependencies>
    <!-- Spring Data JPA -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <!-- Hibernate Dialect and JDBC Driver dependencies-->
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>google-cloud-spanner-hibernate-dialect</artifactId>
    </dependency>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>google-cloud-spanner-jdbc</artifactId>
    </dependency>
  </dependencies>

Configuração

Configure application.properties para usar o dialeto Hibernate do Spanner e o driver JDBC do Spanner.

# Spanner connection URL.
# - ${PROJECT_ID} Replace with your GCP project ID
# - ${INSTANCE_ID} Replace with your Spanner instance ID
# - ${DATABASE_NAME} Replace with the name of your Spanner database that you created inside your Spanner instance

spring.datasource.url=jdbc:cloudspanner:/projects/${PROJECT_ID}/instances/${INSTANCE_ID}/databases/${DATABASE_NAME}

# Specify the Spanner JDBC driver.
spring.datasource.driver-class-name=com.google.cloud.spanner.jdbc.JdbcDriver

# Specify the Spanner Hibernate dialect.
spring.jpa.properties.hibernate.dialect=com.google.cloud.spanner.hibernate.SpannerDialect

spring.jpa.hibernate.ddl-auto=update

# Settings to enable batching statements for efficiency
spring.jpa.properties.hibernate.jdbc.batch_size=100
spring.jpa.properties.hibernate.order_inserts=true

# You can display SQL statements and stats for debugging if needed.
spring.jpa.properties.hibernate.show_sql=true
spring.jpa.properties.hibernate.format_sql=true

Aplicativo de exemplo completo

Um aplicativo de exemplo funcional (link em inglês) está disponível no GitHub.

A seguir