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; sollten alle anderen Nutzenden Nur Spanner-R2DBC-Treiber.

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.

Spring Data R2DBC-Features verwenden mit Spanner die folgende Abhängigkeit zu Ihrem Projekt hinzufügen. 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 R2DBC-Referenz von Spring Data Informationen dazu, welche Objekte automatisch für Sie konfiguriert werden, finden Sie in der Spring Boot-Referenz.

Weitere Informationen finden Sie unter Spanner Spring Data R2DBC GitHub-Repository.

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 mit diesen Codebeispiele.
  • Weitere Informationen zu R2DBC
  • GitHub-Problem melden , um einen Fehler zu melden oder eine Frage zur Unterstützung von Spanner R2DBC zu stellen.