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

    Ir al selector de proyectos

  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 la capacidad de procesamiento predeterminada de 1,000 unidades de procesamiento.

    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. Omita el paso Defina su esquema por ahora. Definirás tu esquema en la siguiente sección de esta guía de inicio rápido.

  6. Haga clic en Crear.

    Cloud Console mostrará la página Descripción general de la base de datos que creaste.

Cree un esquema para su base de datos

  1. En la página Descripción general de example-db, haz clic en Crear tabla al comienzo de la lista de tablas.

    En Cloud Console, se muestra la página Escribir declaraciones DDL.

  2. Ingrese lo siguiente:

    CREATE TABLE Singers (
      SingerId   INT64 NOT NULL,
      FirstName  STRING(1024),
      LastName   STRING(1024),
      SingerInfo BYTES(MAX),
      BirthDate  DATE,
    ) PRIMARY KEY(SingerId);
    

  3. Haga clic en Enviar.

    Cloud Console vuelve a la página Descripción general de example-db y muestra que las actualizaciones de esquemas están en curso. Cuando finalice la actualización, la página se verá de la siguiente manera:

    Captura de pantalla de la tabla

Inserta datos y modifícalos

Cloud Console proporciona una interfaz para insertar, editar y borrar datos.

Inserte datos

  1. En la página Descripción general de example-db, haz clic en la tabla Cantantes en la lista de tablas.

    Cloud Console mostrará la página Esquema de la tabla Cantantes.

  2. En el menú lateral, haz clic en Datos (Data) para mostrar la página Datos de la tabla Cantantes.

  3. Haga clic en Insert.

    Cloud Console muestra la página Consulta de la tabla Cantantes con una nueva pestaña de consulta que contiene las plantillas INSERT y las declaraciones SELECT que editas para insertar una fila en la tabla. ver el resultado de esa inserción:

      -- 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>;
    
  4. Edita la cláusula VALUES de la declaración INSERT y la cláusula WHERE de la declaración SELECT:

      -- 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;
    
  5. Haga clic en Ejecutar.

    Cloud Spanner ejecuta las instrucciones. Cuando finalizas, 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.

  6. En la pestaña Resultados, haga clic en el vínculo tabla. La tabla Singers ahora tiene una fila:

    Captura de pantalla de los datos de la tabla Cantantes (Singers) con una fila

  7. Haga clic en Insert para agregar una fila adicional.

    Cloud Console volverá a mostrar la página Consulta de la tabla Cantantes con una nueva pestaña de consulta que contiene las mismas instrucciones INSERT y SELECT de la plantilla.

  8. Edita la cláusula VALUES de la declaración INSERT y la cláusula WHERE de la declaración SELECT:

      -- 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;
    
  9. Haga clic en Ejecutar.

    Después de que Cloud Spanner ejecute las declaraciones, la pestaña Resultados indica de nuevo que la primera declaración insertó una fila.

  10. Haga clic en el vínculo tabla. Ahora la tabla Singers tiene dos filas:

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

También, puede insertar valores de string vacía cuando ingrese datos:

  1. Haga clic en Insertar para agregar una fila.

    Cloud Console volverá a mostrar la página Consulta de la tabla Cantantes con una nueva pestaña de consulta que contiene las mismas instrucciones INSERT y SELECT de la plantilla.

  2. Edita la cláusula VALUES de la declaración INSERT de la plantilla y la cláusula WHERE de la declaración SELECT:

        -- 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;
    

    Ten en cuenta que el valor proporcionado para LastName es una string vacía, '', no un valor NULL.

  3. Haga clic en Ejecutar.

    Después de que Cloud Spanner ejecute las declaraciones, la pestaña Resultados indica de nuevo que la primera declaración insertó una fila.

  4. Haga clic en el vínculo tabla. Ahora la tabla Singers tiene tres filas, y la fila para SingerID 3 tiene un LastName que es una string vacía:

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

Edite datos

  1. En la página Datos de la tabla Cantantes, marca la casilla junto a la fila 3 de SingerId y haz clic en Editar.

    Cloud Console muestra la página Consultas de la tabla Cantantes con una nueva pestaña de consulta que contiene las plantillas UPDATE y las declaraciones SELECT que editas para actualizar la fila en la tabla Cantantes. ver el resultado de esa actualización. Ten en cuenta que las cláusulas WHERE de ambas declaraciones indican que la fila que se actualizará es la de SingerId 3.

      -- 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;
    
  2. Edita la cláusula SET de la declaración UPDATE para actualizar solo la columna BirthDate:

      -- 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;
    
  3. Haga clic en Ejecutar.

    Cloud Spanner ejecuta las instrucciones. Cuando finalizas, 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.

  4. En la pestaña Resultados, haga clic en el vínculo tabla. Ahora, la fila SingerId 3 en la tabla Singers tiene un valor 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 la página Datos de la tabla Cantantes, marca la casilla junto a la fila 2 de SingerId y haz clic en Borrar.
  2. 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á

Ejecute una consulta

  1. En la página Descripción general de example-db, haz clic en Consulta en el menú lateral para mostrar la página Consulta de example-db.

  2. Haz clic en Nueva pestaña para crear una pestaña de consulta nueva. Luego, ingresa esta consulta:

    SELECT * FROM Singers;
    
  3. Haga clic en Ejecutar.

    Cloud Spanner ejecuta la consulta. Cuando termines, en la pestaña Resultados (Results), se mostrará 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 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 BORRAR BASE DE DATOS.

  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?