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, una base de datos y una tabla de Cloud Spanner
- Agregar un esquema
- Escribir y modificar datos
- Ejecutar una consulta
Antes de comenzar
- Accede a tu Cuenta de Google.
Si todavía no tienes una cuenta, regístrate para obtener una nueva.
-
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.
-
Habilita 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.
Ve a la página Instancias de Cloud Spanner en Cloud Console.
Haz clic en Crear instancia.
En el nombre de la instancia, escribe Instancia de prueba (Test instance).
En el ID de instancia, escribe test-instance.
Usa una configuración Regional.
Elige cualquier configuración regional en el menú desplegable.
La configuración de tu instancia determina la ubicación geográfica donde tus instancias se almacenan y se replican.
Usa 1 para el recuento de nodos.
La página de creación de la instancia debería verse así:
Haz clic en Crear (Create).
Tu instancia aparece en la lista de instancias.
Crea una base de datos
Ve a la página Instancias de Cloud Spanner en Cloud Console.
Haz clic en la instancia Instancia de prueba.
Haz clic en Crear base de datos.
En el nombre de la base de datos, escribe example-db.
La página de creación de la base de datos ahora se ve de la siguiente manera:
Haz clic en Continuar (Continue).
Omite el paso Define el esquema de base de datos (Define your database schema) por ahora. Definirás tu esquema en la siguiente sección de esta guía de inicio rápido.
Haz clic en Crear.
Cloud Console muestra la página Detalles de la base de datos después de crear la base de datos.
Crea un esquema para tu base de datos
Cloud Console proporciona dos maneras de crear, modificar y borrar índices y tablas en una base de datos:
- Mediante el editor de bases de datos predeterminado para especificar cada parte de las tablas, las columnas y los índices.
- Con el cambio del editor al modo Editar como texto y la escritura de instrucciones de SQL en la sintaxis del lenguaje de definición de datos (DDL) de Cloud Spanner.
En esta guía de inicio rápido, se usa DDL.
- En el panel izquierdo de Cloud Console, haz clic en la base de datos example-db.
- Haz clic en Crear tabla.
- Haga clic en el botón de activar o desactivar Edit as text.
En el campo declaración DDL, escribe lo siguiente:
CREATE TABLE Singers ( SingerId INT64 NOT NULL, FirstName STRING(1024), LastName STRING(1024), SingerInfo BYTES(MAX), BirthDate DATE, ) PRIMARY KEY(SingerId);
Haga clic en Crear.
Este proceso puede tardar unos minutos. Cuando se completa la operación, Cloud Console muestra los detalles de la tabla que creaste:
Inserta datos y modifícalos
Cloud Console proporciona una interfaz para insertar, editar y borrar datos.
Inserta datos
- En el panel izquierdo de Cloud Console, haz clic en Cantantes (Singers).
- Haz clic en Datos (Data).
- Haz clic en Insertar (Insert).
Ingresa los siguientes valores:
Campo Valor SingerID:INT64 1
BirthDate:DATE [déjelo en blanco] FirstName:STRING Marc
LastName:STRING Richards
SingerInfo:BYTES [déjelo en blanco] Haga clic en Save.
La tabla Cantantes (Singers) ahora tiene una fila:
Haz clic en Insertar (Insert) para agregar una fila adicional.
Ingresa los siguientes valores:
Campo Valor SingerID:INT64 2
BirthDate:DATE [déjelo en blanco] FirstName:STRING Catalina
LastName:STRING Smith
SingerInfo:BYTES [déjelo en blanco] Haga clic en Save.
Ahora, la tabla Cantantes (Singers) tiene dos filas:
También puedes insertar valores de string vacía cuando ingreses datos.
- En el panel izquierdo, haz clic en Cantantes (Singers).
- Haz clic en Datos (Data).
- Haz clic en Insertar (Insert).
Ingresa los siguientes valores:
Campo Valor SingerID:INT64 3
BirthDate:DATE [déjelo en blanco] FirstName:STRING Kena
LastName:STRING [verifica String vacía] SingerInfo:BYTES [déjelo en blanco] Haz clic en Guardar.
Ahora la tabla Singers tiene tres filas, y la fila SingerID
3
tiene una string vacía en LastName:
Edita datos
- En el panel izquierdo de Cloud Console, haz clic en Cantantes (Singers).
- Haz clic en Datos (Data).
- Marca la casilla junto a la fila SingerId
3
y, luego, haz clic en Editar (Edit). Ingresa el siguiente valor:
Campo Valor BirthDate:DATE 1961-04-01
[todos los otros campos] [déjelos como aparecen] Haz clic en Guardar.
Ahora la fila SingerId
3
de la tabla Singers tiene un valor para BirthDate:
Borra datos
- En el panel izquierdo de Cloud Console, haz clic en Cantantes (Singers).
- Haz clic en Datos (Data).
- Marca la casilla junto a la fila SingerId
2
y haz clic en Borrar (Delete). En el cuadro de diálogo que aparece, haz clic en Aceptar.
Ahora, la tabla Cantantes (Singers) tiene dos filas:
Ejecuta una consulta
Ahora puedes ejecutar una instrucción de SQL en la página de consultas.
- En el panel izquierdo de Cloud Console, haz clic en example-db para navegar a la página Detalles de la base de datos.
- En la página Detalles de la base de datos, haz clic en Consultar.
Para la consulta, ingresa lo siguiente:
SELECT * FROM Singers
Haz clic en Ejecutar consulta.
Cloud Console muestra el resultado de tu consulta:
Felicitaciones. Creaste una base de datos de Cloud Spanner de manera correcta y ejecutaste una instrucción de SQL con el editor de consultas.
Realiza una limpieza
Para evitar que se apliquen cargos adicionales a tu cuenta de Google Cloud, borra la base de datos y la instancia que creaste.
Borra la base de datos
Ve a la página Instancias de Cloud Spanner en Google Cloud Console.
Haz clic en Probar instancia.
Haz clic en example-db.
En la página Detalles de la base de datos, haz clic en DELETE DATABASE delete.
Confirma que deseas borrar la base de datos y haz clic en Borrar.
Borra la instancia
Si borras una instancia, se borrarán de forma automática todas las bases de datos creadas en esa instancia.
Ve a la página Instancias de Cloud Spanner en Google Cloud Console.
Haz clic en Probar instancia.
Haz clic en delete BORRAR INSTANCIA.
Confirma que deseas borrar la instancia y haz clic en Borrar.
¿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).
- 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.