Guía de inicio rápido con 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, una base de datos y una tabla de Cloud Spanner
• Agregar un esquema
• Escribir y modificar datos
• Ejecutar una consulta

Nota: Para obtener información sobre el costo de usar Cloud Spanner, consulta la página Precios.

Antes de comenzar

1. 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.

2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyecto

3. Comprueba que la facturación esté habilitada en tu proyecto.

   Descubre cómo puedes habilitar la facturación

4. Habilita la API de Cloud Spanner para el proyecto.

   Habilitar la API de Cloud Spanner.

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.

1. Ve a la página Instancias de Cloud Spanner en Cloud Console.

   Ir a la página Instancias

2. Haz clic en Crear instancia.

3. En el nombre de la instancia, escribe Instancia de prueba (Test instance).

4. En el ID de instancia, escribe test-instance.

5. Usa una configuración Regional.

6. 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.

7. Usa 1 para el recuento de nodos.

   La página de creación de la instancia debería verse así:

   

8. Haz clic en Crear (Create).

   Tu instancia aparece en la lista de instancias.

Crea una base de datos

1. Ve a la página Instancias de Cloud Spanner en Cloud Console.

   Ir a la página Instancias

2. Haz clic en la instancia Instancia de prueba.

3. Haz clic en Crear base de datos.

4. 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:

   

5. Omite el paso Define tu esquema (Define your schema) por ahora. Definirás tu esquema en la siguiente sección de esta guía de inicio rápido.

6. 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.

1. En el panel izquierdo de Cloud Console, haz clic en la base de datos example-db.
2. Haz clic en Crear tabla.
3. Haga clic en el botón de activar o desactivar Edit as text.

4. 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);
   

5. 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

1. En el panel izquierdo de Cloud Console, haz clic en Cantantes (Singers).
2. Haz clic en Datos (Data).
3. Haz clic en Insertar (Insert).

4. 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]

5. Haga clic en Save.

   La tabla Cantantes (Singers) ahora tiene una fila:

   

6. Haz clic en Insertar (Insert) para agregar una fila adicional.

7. 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]

8. Haga clic en Save.

   Ahora, la tabla Cantantes (Singers) tiene dos filas:

   

También puedes insertar valores de string vacía cuando ingreses datos.

1. En el panel izquierdo, haz clic en Cantantes (Singers).
2. Haz clic en Datos (Data).
3. Haz clic en Insertar (Insert).

4. 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]

5. 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

1. En el panel izquierdo de Cloud Console, haz clic en Cantantes (Singers).
2. Haz clic en Datos (Data).
3. Marca la casilla junto a la fila SingerId 3 y, luego, haz clic en Editar (Edit).

4. Ingresa el siguiente valor:

   Campo	Valor
   BirthDate:DATE	1961-04-01
   [todos los otros campos]	[déjelos como aparecen]

5. Haz clic en Guardar.

   Ahora la fila SingerId 3 de la tabla Singers tiene un valor para BirthDate:

   

Borra datos

1. En el panel izquierdo de Cloud Console, haz clic en Cantantes (Singers).
2. Haz clic en Datos (Data).
3. Marca la casilla junto a la fila SingerId 2 y haz clic en Borrar (Delete).

4. En el cuadro de diálogo que aparece, haz clic en Confirmar.

   Ahora, la tabla Singers tiene dos filas:

   

Ejecuta una consulta

Ahora puedes ejecutar una instrucción de SQL en la página de consultas.

1. En el panel izquierdo de Cloud Console, haz clic en example-db para navegar a la página Detalles de la base de datos.
2. En la página Detalles de la base de datos, haz clic en Consultar.

3. Para la consulta, ingresa lo siguiente:

   SELECT * FROM Singers
   

4. Haga clic en Ejecutar.

   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.

Limpieza

Para evitar que se apliquen cargos adicionales a tu cuenta de facturación de Cloud, borra la base de datos y la instancia que creaste.

Borra la base de datos

1. Ve a la página Instancias de Cloud Spanner en Google Cloud Console.

   Ir a la página Instancias

2. Haz clic en Probar instancia.

3. Haz clic en example-db.

4. En la página Detalles de la base de datos, haz clic en DELETE DATABASE .

5. 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.

1. Ve a la página Instancias de Cloud Spanner en Google Cloud Console.

   Ir a la página Instancias

2. Haz clic en Probar instancia.

3. Haz clic en BORRAR INSTANCIA.

4. 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.