Utilizzare il driver R2DBC open source

R2DBC è una specifica per l'accesso non bloccante ai database relazionali, basata su Reactive Streams. La tua applicazione può utilizzare la connettività del database reattivo con Spanner utilizzando il driver R2DBC di Spanner.

Aggiungi le dipendenze

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

Utilizzare il driver R2DBC di Spanner

Per aggiungere solo il driver R2DBC di Spanner all'applicazione, aggiungi la seguente dipendenza:

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

Per ulteriori informazioni, consulta il repository GitHub del driver Spanner R2DBC e il codice di esempio.

Utilizzare il dialetto Spring Data R2DBC per Spanner

Per gli utenti di Spring Framework, 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 il modello e i repository, consulta la documentazione di riferimento di Spring Data R2DBC. Per vedere quali oggetti vengono configurati automaticamente per te, consulta la documentazione di riferimento di Spring Boot.

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

Configurazione di Spring Boot

Indipendentemente dalla dipendenza R2DBC utilizzata, se la tua applicazione è basata su Spring Boot, il framework tenterà di configurare e fornire automaticamente una factory di connessione.

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

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

Passaggi successivi