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 Datenbankverbindung mit Spanner mithilfe des R2DBC-Treibers von Spanner nutzen.

Abhängigkeiten hinzufügen

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

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 des Spanner-R2DBC-Treibers 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 Features von Spring Data R2DBC 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>

In der Referenz zu Spring Data R2DBC erfahren Sie, wie Sie seine Vorlage und Repositories verwenden. In der Spring Boot-Referenz erfahren Sie, welche Objekte automatisch konfiguriert werden.

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

• Weitere Informationen zur Verwendung von Spanner über R2DBC finden Sie in diesen Codebeispielen.
• Weitere Informationen zu R2DBC
• Ein GitHub-Problem senden, um einen Fehler zu melden oder eine Frage zum Spanner-R2DBC-Support zu stellen.