Cette page explique comment effectuer des opérations de base dans Spanner à l'aide du pilote JDBC de Spanner.
Installer le pilote JDBC
Suivez les étapes décrites dans les bibliothèques clientes Spanner pour configurer l'authentification, puis ajoutez les dépendances des pilotes JDBC Spanner, indiquées dans l'extrait de code suivant, à votre fichier pom.xml
.
Si vous utilisez un framework qui nécessite le nom de la classe Java pour charger le pilote JDBC, il s'agit de
com.google.cloud.spanner.jdbc.JdbcDriver
. Consultez la documentation de l'API pour JdbcDriver afin de découvrir comment configurer une connexion.
Se connecter à une base de données Spanner
La description de la classe JdbcDriver indique la syntaxe de la chaîne de connexion et inclut un exemple de code permettant de créer une connexion et d'exécuter une requête.
Le pilote détecte automatiquement le dialecte SQL (GoogleSQL ou PostgreSQL) de la base de données spécifiée. Un paramètre de dialecte n'est ni obligatoire, ni autorisé.
Se connecter à l'émulateur
Pour vous connecter à l'émulateur, définissez la variable d'environnement SPANNER_EMULATOR_HOST
, par exemple :
Linux/macOS
export SPANNER_EMULATOR_HOST=localhost:9010
Windows
set SPANNER_EMULATOR_HOST=localhost:9010
Cela indique au pilote du pilote JDBC Spanner de se connecter à l'émulateur s'exécutant sur localhost
au lieu du service de production par défaut.
Examples
Les exemples de code suivants couvrent certains cas d'utilisation courants.
Exécuter une mise à jour du schéma
L'exemple de code suivant ajoute la table Singers
à la base de données en créant d'abord une connexion JDBC, puis en créant la table :
Utiliser une transaction en mode autocommit pour ajouter des lignes
Si vous n'avez pas besoin de valider plusieurs opérations en tant que groupe, vous pouvez utiliser une transaction en mode autocommit, qui est le comportement par défaut. L'exemple de code suivant utilise une transaction en mode autocommit pour ajouter des lignes de la table Singers
:
Contrôler le commit de plusieurs opérations en tant que groupe
Si vous souhaitez contrôler si Spanner valide ou non plusieurs opérations en tant que groupe, vous pouvez désactiver le mode autocommit. L'exemple de code suivant utilise connection.setAutoCommit(false)
et connection.commit()
pour ajouter des lignes à la table Singers
.
Exécuter une requête SQL
L'exemple de code suivant renvoie toutes les lignes de la table Singers
triées par nom de chanteur :
Étapes suivantes
- Obtenez des réponses aux questions fréquentes sur le pilote JDBC Spanner.
- Découvrez les commandes de gestion des sessions du pilote JDBC Spanner.