En esta página, se muestra cómo realizar operaciones básicas en Spanner mediante el controlador JDBC de Spanner.
Instala el controlador JDBC
Sigue los pasos que se indican en Bibliotecas cliente de Spanner para configurar la autenticación y, luego, agrega las dependencias del controlador de JDBC de Spanner, que se muestran en el siguiente fragmento, a tu archivo pom.xml
.
En caso de que uses un framework que requiera el nombre de clase de Java para cargar el controlador de JDBC, es
com.google.cloud.spanner.jdbc.JdbcDriver
. Consulta la documentación de la API de JdbcDriver para obtener información sobre cómo configurar una conexión.
Conéctate a una base de datos de Spanner
La descripción de la clase JdbcDriver muestra la sintaxis de la string de conexión y, además, incluye el código de muestra para crear una conexión y ejecutar una consulta.
El controlador detecta automáticamente el dialecto SQL (GoogleSQL o PostgreSQL) de la base de datos especificada. Un parámetro de dialecto no es necesario ni permitido.
Cómo conectarse al emulador
Para conectarte al emulator, configura la variable de entorno SPANNER_EMULATOR_HOST
, por ejemplo:
Linux/macOS
export SPANNER_EMULATOR_HOST=localhost:9010
Windows
set SPANNER_EMULATOR_HOST=localhost:9010
Esto le indica al controlador del controlador JDBC de Spanner que se conecte al emulador que se ejecuta en localhost
en lugar del servicio de producción predeterminado.
Ejemplos
Los siguientes ejemplos de código abarcan algunos casos de uso comunes.
Ejecuta una actualización de esquema
En el siguiente ejemplo de código, se agrega la tabla Singers
a la base de datos mediante la creación de una conexión JDBC y, luego, se crea:
Usa una transacción en el modo de confirmación automática para agregar filas
Si no necesitas confirmar varias operaciones como un grupo, puedes usar una transacción en el modo de confirmación automática, que es el comportamiento predeterminado. En el siguiente ejemplo de código, se usa una transacción en el modo de confirmación automática para agregar filas a la tabla Singers
:
Controla cómo se confirman varias operaciones en grupo
Si deseas controlar si Spanner confirma varias operaciones como un grupo, puedes inhabilitar el modo de confirmación automática. En el siguiente ejemplo de código, se usan connection.setAutoCommit(false)
y connection.commit()
para agregar filas a la tabla Singers
.
Ejecuta una consulta de SQL
En el siguiente ejemplo de código, se muestran todas las filas de la tabla Singers
ordenadas por el apellido del cantante:
¿Qué sigue?
- Obtén respuestas a las preguntas frecuentes sobre el controlador JDBC de Spanner.
- Obtén información sobre los comandos de administración de sesiones del controlador de JDBC de Spanner.