Guía de inicio rápido

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

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

    Descubre cómo puedes habilitar la facturación

  6. 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. Selecciona un dialecto de la base de datos.

    Si deseas obtener información sobre la compatibilidad con PostgreSQL y la orientación para elegir un dialecto, consulta la interfaz de PostgreSQL.

  6. Si seleccionaste SQL estándar de Google, deja en blanco el campo de texto Define el esquema. Definirás tu esquema en la siguiente sección de esta guía de inicio rápido.

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

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

    SQL estándar de Google

    Captura de pantalla de la tabla

    PostgreSQL

    Captura de pantalla de la tabla

    Tenga en cuenta que PostgreSQL convierte el nombre de la tabla en minúsculas.

Inserte datos y modifíquelos

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 (Tables) 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 Cantantes. 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.

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

    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;
    
  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, haz clic en el vínculo tabla. La tabla Singers ahora tiene una fila:

    SQL estándar de Google

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

    PostgreSQL

    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 muestra la página Consulta de la tabla Singers con una pestaña de consulta nueva que contiene las mismas declaraciones INSERT y SELECT de plantilla.

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

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

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

  10. Haga clic en el vínculo tabla. La tabla Singers ahora tiene dos filas:

    SQL estándar de Google

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

    PostgreSQL

    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 muestra la página Consulta de la tabla Singers con una pestaña de consulta nueva que contiene las mismas declaraciones INSERT y SELECT de 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:

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

  3. Haga clic en Ejecutar.

    Después de que Cloud Spanner ejecute las declaraciones, la pestaña Resultados indica nuevamente 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 con el valor de clave primaria de 3 tiene una columna de apellido que es una string vacía:

    SQL estándar de Google

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

    PostgreSQL

    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, marque la casilla junto a la fila con el valor de clave primaria de 3 y, luego, haga clic en Editar.

    En Cloud Console, se muestra la página Consulta con una pestaña nueva que contiene las instrucciones de la plantilla UPDATE y SELECT que editas. Ten en cuenta que las cláusulas WHERE de ambas declaraciones indican que la fila para actualizar es la que tiene el valor de clave primaria de 3.

    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='',
      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 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';
    
  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, haz clic en el vínculo tabla.

    La fila actualizada ahora tiene un valor para la fecha de nacimiento.

    SQL estándar de Google

    Captura de pantalla de los datos de la tabla Cantantes con una fila actualizada

    PostgreSQL

    Captura de pantalla de los datos de la tabla Cantantes con una fila actualizada

Borra datos

  1. En la página Datos de la tabla Cantantes, marque la casilla junto a la fila con 2 en la primera columna y, luego, haga clic en Borrar.
  2. En el diálogo que aparece, haga clic en Confirmar.

    Ahora la tabla Singers tiene dos filas:

    SQL estándar de Google

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

    PostgreSQL

    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:

    SQL estándar de Google

    SELECT * FROM Singers;
    

    PostgreSQL

    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:

    SQL estándar de Google

    Captura de pantalla de los resultados de la consulta

    PostgreSQL

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