Open-Source-R2DBC-Treiber verwenden

R2DBC ist eine Spezifikation für den nicht blockierenden Zugriff auf relationale Datenbanken, die auf Reaktiven Streams basiert. Ihre Anwendung kann die reaktive Datenbankkonnektivität mit Spanner mithilfe des Spanner-R2DBC-Treibers nutzen.

Abhängigkeiten hinzufügen

Spring Data-Nutzer sollten den Spring Data R2DBC-Dialekt für Spanner verwenden. Alle anderen Nutzer sollten nur den Spanner-R2DBC-Treiber einbinden.

Spanner R2DBC-Treiber verwenden

Fügen Sie die folgende Abhängigkeit hinzu, um Ihrer Anwendung nur den Spanner R2DBC-Treiber hinzuzufügen:

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

Weitere Informationen finden Sie im GitHub-Repository für Spanner R2DBC-Treiber und im Beispielcode.

Spring Data R2DBC-Dialekt für Spanner verwenden

Für die Nutzer des Spring Framework bietet Spring Data bekannte Abstraktionen, um die Interaktion mit gängigen Datenbankvorgängen zu vereinfachen.

Wenn Sie Spring Data R2DBC-Features mit Spanner verwenden möchten, fügen Sie Ihrem Projekt die folgende Abhängigkeit hinzu. Der Treiber ist eine transitive Abhängigkeit des Dialekts.

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

Informationen zur Verwendung der Vorlage und der Repositories finden Sie in der Spring Data R2DBC-Referenz. Informationen dazu, welche Objekte automatisch für Sie konfiguriert werden, finden Sie in der Spring Boot-Referenz.

Weitere Informationen finden Sie im GitHub-Repository für Spanner Spring Data R2DBC.

Spring Boot-Konfiguration

Unabhängig von der verwendeten R2DBC-Abhängigkeit versucht das Framework, automatisch eine Verbindungs-Factory zu konfigurieren und bereitzustellen, wenn Ihre Anwendung auf Spring Boot basiert.

Geben Sie ein spring.r2dbc.url-Attribut an, damit die automatische Konfiguration die R2DBC-Verbindungs-Factory-Konfiguration übernimmt. Das Format wird im folgenden application.properties-Beispieleintrag gezeigt:

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

Nächste Schritte