Auf dieser Seite erfahren Sie, wie Sie mithilfe der Spanner-JDBC-Treiber.
JDBC-Treiber installieren
Führen Sie die Schritte unter Spanner-Clientbibliotheken aus.
um die Authentifizierung einzurichten, und fügen Sie dann den Spanner-JDBC-Treiber hinzu.
-Abhängigkeiten, wie im folgenden Snippet gezeigt, in Ihre pom.xml
-Datei ein.
Wenn Sie ein Framework verwenden, das den Java-Klassennamen erfordert, um den JDBC-Treiber zu laden, ist es
com.google.cloud.spanner.jdbc.JdbcDriver
. Weitere Informationen finden Sie unter
die API-Dokumentation für JdbcDriver
um eine Verbindung herzustellen.
Verbindung zu einer Spanner-Datenbank herstellen
Den JdbcDriver Klassenbeschreibung zeigt die Syntax des Verbindungsstrings und enthält Beispielcode für eine Verbindung herstellen und eine Abfrage ausführen.
Der Treiber erkennt automatisch den SQL-Dialekt (GoogleSQL oder PostgreSQL) der angegebenen Datenbank. Ein Dialektparameter ist nicht erforderlich oder zulässig.
Mit dem Emulator verbinden
Wenn Sie eine Verbindung zum Emulator herstellen möchten, legen Sie die Umgebungsvariable SPANNER_EMULATOR_HOST
fest. Beispiel:
Linux/macOS
export SPANNER_EMULATOR_HOST=localhost:9010
Windows
set SPANNER_EMULATOR_HOST=localhost:9010
Dadurch wird der JDBC-Treibertreiber von Spanner angewiesen, eine Verbindung zum
Emulator, der auf der localhost
anstelle des Standardproduktionsdienstes ausgeführt wird.
Beispiele
Die folgenden Codebeispiele decken einige gängige Anwendungsfälle ab.
Schemaaktualisierung ausführen
Im folgenden Codebeispiel wird die Tabelle Singers
der Datenbank hinzugefügt. Dazu wird zuerst eine JDBC-Verbindung und dann die Tabelle erstellt:
Zeilen mit einer Transaktion im automatischen Commit-Modus hinzuzufügen
Wenn Sie nicht mehrere Vorgänge als Gruppe ausführen müssen, können Sie eine Transaktion im Autocommit-Modus verwenden. Dies ist das Standardverhalten. Im folgenden Codebeispiel wird eine Transaktion im Autocommit-Modus verwendet, um der Tabelle Singers
Zeilen hinzuzufügen:
Steuern, wie mehrere Vorgänge als Gruppe durchgeführt werden
Wenn Sie steuern möchten, ob Spanner für mehrere Vorgänge Commits durchführt
gemeinsam als Gruppe haben, können Sie den Autocommit-Modus deaktivieren. Im folgenden Codebeispiel werden connection.setAutoCommit(false)
und connection.commit()
zum Hinzufügen von Zeilen zur Tabelle Singers
verwendet.
SQL-Abfrage ausführen
Im folgenden Codebeispiel werden alle Zeilen in der Tabelle Singers
zurückgegeben, sortiert nach dem Nachnamen des Sängers:
Nächste Schritte
- Antworten auf häufig gestellte Fragen zum JDBC-Treiber für Spanner.
- Informationen zu Befehlen zur Sitzungsverwaltung für den Spanner-JDBC-Treiber.