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
- Saiba mais sobre o Spring Data JPA.
- Saiba mais sobre o Hibernate ORM.
- Veja o repositório do Dialeto do Spanner no GitHub.
- Registre um problema no GitHub (em inglês) para relatar um bug ou fazer uma pergunta sobre o Hibernate.
- Integre o Spanner com o Spring Data JPA (dialeto PostgreSQL).