Utilizzare il driver R2DBC open source

R2DBC è una specifica per l'accesso senza blocco ai database relazionali, basata sui flussi reattivi. L'applicazione può utilizzare la connettività reattiva del database con Spanner utilizzando il driver R2DBC di Spanner.

Aggiungi dipendenze

Gli utenti di Spring Data devono utilizzare il dialetto R2DBC di Spring Data per Spanner; tutti gli altri utenti devono utilizzare solo il driver R2DBC di Spring Data.

Usa il driver R2DBC di Spanner

Per aggiungere solo il driver R2DBC di Spanner alla tua applicazione, aggiungi la seguente dipendenza:

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

Per maggiori informazioni, consulta il repository GitHub del driver R2DBC di Spanner e il codice campione.

Usa il dialetto R2DBC di Spring Data per Spanner

Per gli utenti del framework Spring, Spring Data fornisce astrazioni familiari per semplificare l'interazione con le operazioni di database comuni.

Per utilizzare le funzionalità di Spring Data R2DBC con Spanner, aggiungi la seguente dipendenza al progetto. Il driver è una dipendenza transitiva del dialetto.

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

Per scoprire come utilizzare i relativi modelli e repository, consulta il riferimento R2DBC di Spring Data. Per sapere quali oggetti vengono configurati automaticamente, consulta la documentazione di Spring Boot.

Per maggiori informazioni, consulta il repository GitHub Spanner Spring Data R2DBC.

Configurazione di Spring Boot

Indipendentemente dalla dipendenza R2DBC che utilizzi, se l'applicazione è basata su Spring Boot, il framework tenterà di configurare automaticamente e di fornirti una fabbrica di connessione.

Fornisci una proprietà spring.r2dbc.url per consentire alla configurazione automatica di gestire la configurazione di fabbrica della connessione R2DBC. Il formato viene mostrato nella seguente voce di esempio application.properties:

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

Passaggi successivi