Questa pagina mostra come eseguire operazioni di base in Spanner utilizzando il driver JDBC di Spanner.
Installare il driver JDBC
Segui i passaggi nelle librerie client di Spanner per configurare l'autenticazione, quindi aggiungi le dipendenze del driver JDBC di Spanner, mostrate nello snippet seguente, al tuo file pom.xml
.
Se utilizzi un framework che richiede il nome della classe Java per caricare il driver JDBC, questo è
com.google.cloud.spanner.jdbc.JdbcDriver
. Consulta la documentazione dell'API per JdbcDriver per informazioni su come configurare una connessione.
Connettiti a un database Spanner
La descrizione della classe JdbcDriver mostra la sintassi della stringa di connessione e include il codice campione per creare una connessione ed eseguire una query.
Il driver rileva automaticamente il dialetto SQL (GoogleSQL o PostgreSQL) del database specificato. Il parametro dialetto non è obbligatorio né consentito.
Connettiti all'emulatore
Per connetterti all'emulatore, imposta la
variabile di ambiente SPANNER_EMULATOR_HOST
, ad esempio:
Linux / MacOS
export SPANNER_EMULATOR_HOST=localhost:9010
Windows
set SPANNER_EMULATOR_HOST=localhost:9010
In questo modo indichi al driver JDBC di Spanner di connettersi all'emulatore in esecuzione su localhost
anziché al servizio di produzione predefinito.
Esempi
I seguenti esempi di codice coprono alcuni casi d'uso comuni.
Esegui un aggiornamento dello schema
Nell'esempio di codice seguente, la tabella Singers
viene aggiunta al database creando prima una connessione JDBC e, successivamente, creando la tabella:
Utilizzare una transazione in modalità di commit automatico per aggiungere righe
Se non hai bisogno di eseguire il commit di più operazioni come gruppo, puoi utilizzare una transazione in modalità di commit automatico, che è il comportamento predefinito. Il seguente esempio di codice utilizza una transazione in modalità di commit automatico per aggiungere righe alla tabella Singers
:
Controlla come viene eseguito il commit di più operazioni come gruppo
Se vuoi controllare se Spanner esegue il commit di più operazioni
in gruppo, puoi disabilitare la modalità di commit automatico. L'esempio di codice riportato di seguito utilizza connection.setAutoCommit(false)
e connection.commit()
per aggiungere righe alla tabella Singers
.
esegui una query SQL
Il seguente esempio di codice restituisce tutte le righe della tabella Singers
ordinate in base al cognome del cantante:
Passaggi successivi
- Ottieni le risposte alle domande frequenti sul driver JDBC di Spanner.
- Scopri di più sui comandi di gestione delle sessioni del driver JDBC di Spanner.