Usar el controlador R2DBC de código abierto

R2DBC es una especificación para el acceso no bloqueante a bases de datos relacionales basada en Reactive Streams. Tu aplicación puede usar la conectividad reactiva de la base de datos con Spanner mediante el controlador R2DBC de Spanner.

Añadir dependencias

Los usuarios de Spring Data deben usar el dialecto de Spring Data R2DBC para Spanner. El resto de los usuarios solo deben usar el controlador R2DBC de Spanner.

Usar el controlador R2DBC de Spanner

Para añadir solo el controlador R2DBC de Spanner a tu aplicación, añade la siguiente dependencia:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>cloud-spanner-r2dbc</artifactId>
  <version>1.3.0</version>
</dependency>

Para obtener más información, consulta el repositorio de GitHub del controlador R2DBC de Spanner y el código de ejemplo.

Usar el dialecto de Spring Data R2DBC para Spanner

Para los usuarios de Spring Framework, Spring Data proporciona abstracciones conocidas para simplificar la interacción con las operaciones de bases de datos habituales.

Para usar las funciones de Spring Data R2DBC con Spanner, añade la siguiente dependencia a tu proyecto. El controlador es una dependencia transitiva del dialecto.

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>cloud-spanner-spring-data-r2dbc</artifactId>
  <version>1.2.2</version>
</dependency>

Para obtener información sobre cómo usar su plantilla y sus repositorios, consulta la referencia de Spring Data R2DBC. Para ver qué objetos se configuran automáticamente, consulta la referencia de Spring Boot.

Para obtener más información, consulta el repositorio de GitHub de Spanner Spring Data R2DBC.

Configuración de Spring Boot

Independientemente de la dependencia de R2DBC que uses, si tu aplicación se basa en Spring Boot, el framework intentará configurar y proporcionar automáticamente una fábrica de conexiones.

Proporciona una propiedad spring.r2dbc.url para que la configuración automática se encargue de la configuración de la fábrica de conexiones R2DBC. El formato se muestra en la siguiente entrada de ejemplo application.properties:

spring.r2dbc.url=\
r2dbc:cloudspanner://spanner.googleapis.com:443/projects/${project}/instances/${instance}/databases/${database}

Siguientes pasos