Auf dieser Seite wird beschrieben, wie Sie mit dem Spanner-JDBC-Treiber grundlegende Vorgänge in Spanner ausführen.
JDBC-Treiber installieren
Führen Sie die Schritte unter Spanner-Clientbibliotheken aus, um die Authentifizierung einzurichten, und fügen Sie der Datei pom.xml
dann die JDBC-Treiberabhängigkeiten für Spanner hinzu, wie im folgenden Snippet gezeigt.
Wenn Sie ein Framework verwenden, das den Java-Klassennamen erfordert, um den JDBC-Treiber zu laden, ist es
com.google.cloud.spanner.jdbc.JdbcDriver
. Informationen zum Einrichten einer Verbindung finden Sie in der API-Dokumentation zu JdbcDriver.
Verbindung zu einer Spanner-Datenbank herstellen
Die Klassenbeschreibung JdbcDriver zeigt die Syntax des Verbindungsstrings und Beispielcode zum Erstellen einer Verbindung und zum Ausführen einer Abfrage.
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 herzustellen, der auf localhost
ausgeführt wird, anstatt mit dem Standardproduktionsdienst.
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 mehrere Vorgänge zusammen als Gruppe festschreibt, 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 Spanner-JDBC-Treiber
- Informationen zu Befehlen zur Sitzungsverwaltung für den Spanner-JDBC-Treiber.