Utiliser le pilote R2DBC Open Source

R2DBC est une spécification pour l'accès non bloquant aux bases de données relationnelles, basée sur Flux réactifs. Votre application peut exploiter la connectivité réactive de la base de données Spanner à l'aide du pilote Spanner R2DBC.

Ajouter des dépendances

Les utilisateurs de Spring Data doivent utiliser le dialecte Spring Data R2DBC pour Spanner; tous les autres utilisateurs doivent intégrer Pilote Spanner R2DBC uniquement.

Utiliser le pilote Spanner R2DBC

Pour ajouter uniquement le pilote Spanner R2DBC à votre application, ajoutez le la dépendance suivante:

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

Pour en savoir plus, consultez la documentation Spanner R2DBC dépôt GitHub du pilote et l'exemple de code.

Utiliser le dialecte Spring Data R2DBC pour Spanner

Pour les utilisateurs du framework Spring, Spring Data fournit des abstractions familières pour simplifier l'interaction avec les opérations de base de données courantes.

Pour utiliser les fonctionnalités Spring Data R2DBC avec Spanner, ajoutez la dépendance suivante à votre projet. Le pilote est une dépendance transitive du dialecte.

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

Pour apprendre à utiliser son modèle et ses dépôts, consultez la Documentation de référence sur Spring Data R2DBC Pour savoir quels objets sont automatiquement configurés pour vous, consultez la documentation de référence sur Spring Boot.

Pour en savoir plus, consultez la page Spanner Spring Data R2DBC dépôt GitHub.

Configuration de Spring Boot

Quelle que soit la dépendance R2DBC que vous utilisez, si votre application est basée sur Spring Boot, le framework tente de configurer et de vous fournir automatiquement une fabrique de connexions.

Fournissez une propriété spring.r2dbc.url pour permettre à la configuration automatique de se charger de la configuration de la fabrique de connexions R2DBC. Le format est présenté dans l'exemple d'entrée application.properties suivant :

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

Étape suivante