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 exploiter la connectivité réactive de la base de données avec Spanner à l'aide du pilote R2DBC Spanner.

Ajouter des dépendances

Les utilisateurs de Spring Data doivent utiliser le dialecte Spring Data R2DBC pour Spanner. Tous les autres utilisateurs ne doivent utiliser que le pilote R2DBC Spanner.

Utiliser le pilote Spanner R2DBC

Pour ajouter uniquement le pilote R2DBC Spanner à votre application, ajoutez 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 des pilotes Spanner R2DBC 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 de 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 votre, 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}

Étapes suivantes