Se usó la API de Cloud Translation para traducir esta página.
Switch to English

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

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

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

    Ir a la página del selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  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í:

    Captura de pantalla de la ventana de creación de la instancia

  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:

    Captura de pantalla de la ventana de creación de la base de datos

  5. Haz clic en Continuar (Continue).

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

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

    Captura de pantalla de la tabla

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:

    Captura de pantalla de los datos de la tabla Cantantes (Singers) con 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:

    Captura de pantalla de los datos de la tabla Cantantes (Singers) con 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:

    Captura de pantalla de los datos de la tabla Cantantes (Singers) con tres filas

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:

    Captura de pantalla de los datos de la tabla Cantantes (Singers) con tres filas; la tercera fila ahora contiene un valor 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:

    Captura de pantalla de los datos de la tabla Cantantes (Singers) con dos filas; la fila de SingerId 2 ya no está

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:

    Captura de pantalla de los resultados de la 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?