Utiliser le pilote R2DBC Open Source

R2DBC est une spécification permettant d'accéder sans blocage aux bases de données relationnelles. Elle est basée sur des flux réactifs. Votre application peut utiliser la connectivité réactive de la base de données avec Spanner à l'aide du pilote R2DBC pour Spanner.

Ajouter des dépendances

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

Utiliser le pilote R2DBC Spanner

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 le dépôt GitHub du pilote R2DBC pour Spanner 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 savoir comment 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 le dépôt GitHub de Spanner Spring Data R2DBC.

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