Crea y consulta una base de datos con Google Cloud Console
En esta guía de inicio rápido, se muestra cómo realizar operaciones básicas en Cloud Spanner con Google Cloud Console. Esto es lo que harás en la guía de inicio rápido:
- Crear una instancia de Cloud Spanner
- Crear una base de datos
- Crea un esquema.
- Inserte y modifique datos.
- Ejecutar una consulta
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.
-
Comprueba que la facturación esté habilitada en tu proyecto.
-
En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.
-
Comprueba que la facturación esté habilitada en tu proyecto.
-
Habilitar la API de Cloud Spanner para el proyecto
Cree una instancia
Cuando uses Cloud Spanner por primera vez, deberás crear una instancia, que es una asignación de recursos que usan las bases de datos de Cloud Spanner en esa instancia.
En Google Cloud Console, ve a la página Instancias de Cloud Spanner.
Haz clic en Crear instancia.
En el nombre de la instancia, ingresa un nombre, como Probar instancia.
El ID de instancia se ingresa automáticamente según el nombre de la instancia, por ejemplo, test-instance. Si es necesario, cámbialo.
En Choose your configuration, conserve la opción predeterminada Regional y seleccione una configuración del menú desplegable.
La configuración de tu instancia determina la ubicación geográfica donde tus instancias se almacenan y se replican.
En Asignar capacidad de procesamiento, conserva el valor predeterminado de 1,000 unidades de procesamiento.
La página de creación de la instancia debería verse así:
Haga clic en Crear.
La instancia aparecerá en la lista de instancias.
Crear una base de datos
En Google Cloud Console, ve a la página Instancias de Cloud Spanner.
Haz clic en la instancia que creaste, por ejemplo, Instancia de prueba.
En la página Descripción general de la instancia que se abre, haz clic en Crear base de datos.
Para el nombre de la base de datos, ingrese un nombre, como example-db.
Selecciona un dialecto de base de datos.
Si quieres obtener información sobre la compatibilidad con PostgreSQL y orientación para elegir un dialecto, consulta Interfaz de PostgreSQL. Si seleccionaste SQL estándar de Google, definirás el esquema en el campo de texto Definir el esquema en la siguiente sección de esta guía de inicio rápido.
La página de creación de la base de datos ahora se ve de la siguiente manera:
Haga clic en Crear.
Google Cloud Console muestra la página Descripción general de la base de datos que creaste.
Crea un esquema para tu base de datos
En la sección Tablas de la página de descripción general de la base de datos, haga clic en Crear tabla.
En la página Escribir declaraciones DDL, ingresa lo siguiente:
SQL estándar de Google
CREATE TABLE Singers ( SingerId INT64 NOT NULL, FirstName STRING(1024), LastName STRING(1024), SingerInfo BYTES(MAX), BirthDate DATE, ) PRIMARY KEY(SingerId);
PostgreSQL
CREATE TABLE Singers ( SingerId BIGINT PRIMARY KEY, FirstName VARCHAR(1024), LastName VARCHAR(1024), SingerInfo BYTEA, BirthDate TIMESTAMPTZ );
Haga clic en Submit.
Google Cloud Console regresa a la página Descripción general de la base de datos y muestra que las actualizaciones del esquema están en curso. Cuando se complete la actualización, la página se verá de la siguiente manera:
SQL estándar de Google
PostgreSQL
Tenga en cuenta que PostgreSQL convierte el nombre de la tabla en minúsculas.
Inserte datos y modifíquelos
Google Cloud Console proporciona una interfaz para insertar, editar y borrar datos.
Insertar datos
En la lista de tablas de la página Descripción general de la base de datos, haz clic en la tabla Singers.
Google Cloud Console muestra la página Esquema de la tabla de Singers.
En el menú de navegación, haz clic en Datos para mostrar la página Datos de la tabla Cantantes.
Haga clic en Insertar.
Google Cloud Console muestra la página Consulta de la tabla Singers con una pestaña de consulta nueva que contiene instrucciones
INSERT
ySELECT
que puedes editar para insertar una fila en la tabla Singers y ver el resultado de esa inserción:SQL estándar de Google
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO Singers (SingerId, BirthDate, FirstName, LastName, SingerInfo) VALUES (<SingerId>, -- type: INT64 <BirthDate>, -- type: DATE <FirstName>, -- type: STRING(1024) <LastName>, -- type: STRING(1024) <SingerInfo> -- type: BYTES(MAX) ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM Singers WHERE SingerId=<SingerId>;
PostgreSQL
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO singers (singerid, birthdate, firstname, lastname, singerinfo) VALUES (<singerid>, -- type: bigint <birthdate>, -- type: timestamp with time zone <firstname>, -- type: character varying <lastname>, -- type: character varying <singerinfo> -- type: bytea ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM singers WHERE singerid=<singerid>;
Tenga en cuenta que PostgreSQL convierte los nombres de las columnas en minúsculas.
Edita la cláusula
INSERT
sentenciaVALUES
y la cláusulaSELECT
WHERE
:SQL estándar de Google
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO Singers (SingerId, BirthDate, FirstName, LastName, SingerInfo) VALUES (1, -- type: INT64 NULL, -- type: DATE 'Marc', -- type: STRING(1024) 'Richards', -- type: STRING(1024) NULL -- type: BYTES(MAX) ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM Singers WHERE SingerId=1;
PostgreSQL
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO singers (singerid, birthdate, firstname, lastname, singerinfo) VALUES (1, -- type: bigint NULL, -- type: timestamp with time zone 'Marc', -- type: character varying 'Richards', -- type: character varying NULL -- type: bytea ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM singers WHERE singerid=1;
Haga clic en Ejecutar.
Cloud Spanner ejecuta las instrucciones. Cuando termina, la pestaña Resultados indica que la primera declaración insertó una fila y proporciona un vínculo para ver los datos de la tabla.
En la pestaña Resultados, haz clic en el vínculo tabla. Ahora, la tabla Singers tiene una fila:
SQL estándar de Google
PostgreSQL
Haz clic en Insertar para agregar otra fila.
Google Cloud Console vuelve a mostrar la página Consulta de la tabla Singers con una nueva pestaña de consulta que contiene las mismas declaraciones
INSERT
ySELECT
.Edita la cláusula
INSERT
sentenciaVALUES
y la cláusulaSELECT
WHERE
:SQL estándar de Google
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO Singers (SingerId, BirthDate, FirstName, LastName, SingerInfo) VALUES (2, -- type: INT64 NULL, -- type: DATE 'Catalina', -- type: STRING(1024) 'Smith', -- type: STRING(1024) NULL -- type: BYTES(MAX) ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM Singers WHERE SingerId=2;
PostgreSQL
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO singers (singerid, birthdate, firstname, lastname, singerinfo) VALUES (2, -- type: bigint NULL, -- type: timestamp with time zone 'Catalina', -- type: character varying 'Smith', -- type: character varying NULL -- type: bytea ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM singers WHERE singerid=2;
Haga clic en Ejecutar.
Después de que Cloud Spanner ejecuta las declaraciones, la pestaña Resultados vuelve a indicar que la primera declaración insertó una fila.
Haga clic en el vínculo de la tabla. Ahora, la tabla Singers tiene dos filas:
SQL estándar de Google
PostgreSQL
También, puede insertar valores de string vacía cuando ingrese datos:
Haz clic en Insertar para agregar una fila.
Cloud Spanner vuelve a mostrar la página Consulta de la tabla Singers con una nueva pestaña de consulta que contiene las mismas declaraciones
INSERT
ySELECT
.Editar la cláusula
INSERT
de la declaraciónVALUES
ySELECT
la declaraciónWHERE
de la plantilla:SQL estándar de Google
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO Singers (SingerId, BirthDate, FirstName, LastName, SingerInfo) VALUES (3, -- type: INT64 NULL, -- type: DATE 'Kena', -- type: STRING(1024) '', -- type: STRING(1024) NULL -- type: BYTES(MAX) ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM Singers WHERE SingerId=3;
PostgreSQL
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO singers (singerid, birthdate, firstname, lastname, singerinfo) VALUES (3, -- type: bigint NULL, -- type: timestamp with time zone 'Kena', -- type: character varying '', -- type: character varying NULL -- type: bytea ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM singers WHERE singerid=3;
Ten en cuenta que el valor proporcionado para la columna de apellido es una string vacía,
''
, no un valor deNULL
.Haga clic en Ejecutar.
Después de que Cloud Spanner ejecuta las declaraciones, la pestaña Resultados (Results) indica que la primera declaración insertó una fila.
Haga clic en el vínculo de la tabla. Ahora la tabla
Singers
tiene tres filas, y la fila con el valor de clave primaria de3
tiene una string vacía en la columnaLastName
:SQL estándar de Google
PostgreSQL
Edite datos
En la página Datos de la tabla Cantantes, selecciona la casilla de verificación de la fila con el valor de clave primaria de
3
y, luego, haz clic en Editar.Cloud Spanner muestra la página Consulta con una pestaña nueva que contiene las declaraciones
UPDATE
ySELECT
de la plantilla que puedes editar. Ten en cuenta que las cláusulasWHERE
de ambas declaraciones indican que la fila que se actualizará es la que tiene el valor de clave primaria de3
.SQL estándar de Google
-- Change values in the SET clause to update the row where the WHERE condition is true. UPDATE Singers SET BirthDate='', FirstName='Kena', LastName='', SingerInfo='' WHERE SingerId=3; SELECT * FROM Singers WHERE SingerId=3;
PostgreSQL
-- Change values in the SET clause to update the row where the WHERE condition is true. UPDATE singers SET birthdate=NULL, firstname='Kena', lastname='', singerinfo=NULL WHERE singerid='3'; SELECT * FROM singers WHERE singerid='3';
Edita la cláusula
SET
de la sentenciaUPDATE
para actualizar solo la fecha de nacimiento:SQL estándar de Google
-- Change values in the SET clause to update the row where the WHERE condition is true. UPDATE Singers SET BirthDate='1961-04-01' WHERE SingerId=3; SELECT * FROM Singers WHERE SingerId=3;
PostgreSQL
-- Change values in the SET clause to update the row where the WHERE condition is true. UPDATE singers SET birthdate='1961-04-01 00:00:00 -8:00' WHERE singerid='3'; SELECT * FROM singers WHERE singerid='3';
Haga clic en Ejecutar.
Cloud Spanner ejecuta las instrucciones. Cuando termina, la pestaña Resultados indica que la primera declaración actualizó una fila y proporciona un vínculo para ver los datos de la tabla.
En la pestaña Resultados, haz clic en el vínculo tabla.
La fila actualizada ahora tiene un valor para la fecha de nacimiento.
SQL estándar de Google
PostgreSQL
Borra datos
- En la página Data de la tabla de Singers, selecciona la casilla de verificación de la fila con
2
en la primera columna y, luego, haz clic en Delete. En el diálogo que aparece, haga clic en Confirmar.
Ahora, la tabla Singers tiene dos filas:
SQL estándar de Google
PostgreSQL
Ejecute una consulta
En la página Descripción general de la base de datos, haz clic en Consulta en el menú de navegación.
Haz clic en Nueva pestaña para crear una pestaña de consulta nueva. Luego, ingrese la siguiente consulta en el Editor de consultas:
SQL estándar de Google
SELECT * FROM Singers;
PostgreSQL
SELECT * FROM singers;
Haga clic en Ejecutar.
Cloud Spanner ejecuta la consulta. Cuando termines, la pestaña Resultados muestra el resultado de tu consulta:
SQL estándar de Google
PostgreSQL
¡Felicitaciones! Creaste correctamente una base de datos de Cloud Spanner y ejecutaste una instrucción de SQL con el editor de consultas.
Realiza una limpieza
Para evitar cargos adicionales en la cuenta de Facturación de Cloud, borra la base de datos y la instancia que creaste. Si borras una instancia, se borrarán de forma automática todas las bases de datos creadas en ella.
Borra la base de datos
En Google Cloud Console, ve a la página Instancias de Cloud Spanner.
Haz clic en el nombre de la instancia que tiene la base de datos que deseas borrar, por ejemplo, Probar instancia.
Haga clic en el nombre de la base de datos que desea borrar, por ejemplo, example-db.
En la página Detalles de la base de datos, haz clic en delete Borrar base de datos.
Para confirmar que deseas borrar la base de datos, ingresa el nombre de la base de datos y haz clic en Borrar.
Borra la instancia
En Google Cloud Console, ve a la página Instancias de Cloud Spanner.
Haz clic en el nombre de la instancia que deseas borrar, por ejemplo, Probar instancia.
Haz clic en delete Borrar instancia.
Ingresa el nombre de la instancia y haz clic en Borrar para confirmar.
¿Qué sigue?
- Obtén más información sobre instancias.
- Obtén más información sobre el esquema y modelo de datos de Cloud Spanner.
- Obtén más información sobre el lenguaje de definición de datos (DDL) estándar de Google.
- Obtén más información sobre los planes de ejecución de consultas.
- Aprende a usar Cloud Spanner con C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST o gcloud.