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 Spanner-R2DBC-Treiber 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>

Informationen zur Verwendung der Vorlage und der Repositories finden Sie in der Referenz zu Spring Data R2DBC. 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