Utilizzare il driver R2DBC open source

R2DBC è una specifica per l'accesso senza blocco ai database relazionali, basata su Stream reattivi. L'applicazione può utilizzare la connettività reattiva del database con Spanner usando 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 inserire Solo driver R2DBC Spanner.

Usa 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.

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 comuni operazioni sui database.

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 Riferimento R2DBC di Spring Data. 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 viene mostrato nel seguente esempio voce application.properties:

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

Passaggi successivi