Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.
Crea y consulta una base de datos con Google Cloud Console

Crea y consulta una base de datos con Google Cloud Console

En esta guía de inicio rápido, se muestra cómo realizar operaciones básicas en Cloud Spanner mediante Google Cloud Console. Esto es lo que harás en la guía de inicio rápido:

  • Crea una instancia de Spanner.
  • Crear una base de datos.
  • Crea un esquema.
  • Inserta y modifica datos.
  • Ejecutar una consulta

Para obtener información sobre el costo de usar Spanner, consulta 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.

    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.

    Habilita la API

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

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

    Descubre cómo puedes habilitar la facturación

  7. Habilita la API de Cloud Spanner.

    Habilita la API

Crea una instancia

Cuando usas Spanner por primera vez, debes crear una instancia, que es una asignación de recursos que usan las bases de datos de Spanner en esa instancia.

  1. En Google Cloud Console, ve a la página Instancias de Spanner.

    Ir a Instancias de Spanner

  2. Haga clic en Crear instancia.

  3. Para el nombre de la instancia, ingresa un nombre, como Test Instance.

  4. El ID de instancia se ingresa automáticamente según el nombre de la instancia, por ejemplo, como test-instance. Si es necesario, cámbielo.

  5. En Choose your configuration, conserve la opción predeterminada Regional y seleccione una configuración del menú desplegable.

    La configuración de tu instancia determina la ubicación geográfica donde tus instancias se almacenan y se replican.

  6. En Asignar capacidad de procesamiento, conserva el valor predeterminado de 1,000 unidades de procesamiento.

    La página de creación de instancias ahora se ve de la siguiente manera:

    La página de creación de instancias actualizada.

  7. Haz clic en Crear.

    La instancia aparece en la lista de instancias.

Crear una base de datos

  1. En Google Cloud Console, ve a la página Instancias de Spanner.

    Ir a Instancias de Spanner

  2. Haz clic en la instancia que creaste, por ejemplo, Instancia de prueba.

  3. En la página Descripción general de la instancia que se abre, haz clic en Crear base de datos.

  4. Para el nombre de la base de datos, ingresa un nombre, como example-db.

  5. Selecciona un dialecto de base de datos.

    Si quieres obtener información sobre la compatibilidad con PostgreSQL y orientación para elegir un dialecto, consulta la interfaz de PostgreSQL. Si seleccionaste SQL estándar de Google, definirás el esquema en el campo de texto Define tu esquema en la siguiente sección de esta guía de inicio rápido.

    La página de creación de la base de datos ahora se ve de la siguiente manera:

    La ventana de creación de la base de datos actualizada.

  6. Haz clic en Crear.

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

Cree un esquema para su base de datos

  1. En la sección Tablas de la página Descripción general de la base de datos, haz clic en Crear tabla.

  2. En la página Escribir declaraciones DDL, ingresa lo siguiente:

    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. Haz clic en Enviar.

    Google Cloud Console regresa a la página Descripción general de la base de datos y muestra que las actualizaciones del esquema están en curso. Cuando se complete la actualización, la página se verá de la siguiente manera:

    SQL estándar de Google

    La página de resumen actualizada

    PostgreSQL

    La página de resumen actualizada

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

Inserte datos y modifíquelos

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

Insertar datos

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

    Google Cloud Console muestra la página Esquema de la tabla Cantantes.

  2. En el menú de navegación, haga clic en Datos para mostrar la página Datos de la tabla Singers.

  3. Haga clic en Insert.

    Google Cloud Console muestra la página Consulta de la tabla Singers con una pestaña de consulta nueva que contiene las declaraciones INSERT y SELECT que editas para insertar una fila en la tabla Singers y 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.

    Spanner ejecuta las declaraciones. Cuando finaliza, 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 Cantantes ahora tiene una fila:

    SQL estándar de Google

    Los datos de la tabla Cantantes actualizados con una fila.

    PostgreSQL

    Los datos de la tabla Cantantes actualizados con una fila.

  7. Haga clic en Insertar para agregar otra fila.

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

  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.

    Una vez que Spanner ejecuta las declaraciones, la pestaña Results (Resultados) vuelve a indicar que la primera declaración insertó una fila.

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

    SQL estándar de Google

    Se actualizaron los datos de la tabla Cantantes en dos filas.

    PostgreSQL

    Se actualizaron los datos de la tabla Cantantes en dos filas.

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

  1. Haga clic en Insertar para agregar una fila.

    Spanner vuelve a mostrar la página Consulta de la tabla Cantantes con una pestaña de consulta nueva que contiene las mismas declaraciones INSERT y SELECT.

  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 Spanner ejecute las declaraciones, la pestaña Resultados indica que la primera declaración insertó una fila.

  4. Haga clic en el vínculo de la tabla. Ahora, la tabla Singers tiene tres filas, y la fila con el valor de clave primaria de 3 tiene una string vacía en la columna LastName:

    SQL estándar de Google

    Los datos actualizados de la tabla Cantantes con tres filas.

    PostgreSQL

    Los datos actualizados de la tabla Cantantes con tres filas.

Edita datos

  1. En la página Datos de la tabla Cantantes, seleccione la casilla de verificación en la fila con el valor de clave primaria de 3 y, luego, haga clic en Editar.

    Spanner muestra la página Query con una pestaña nueva que contiene las declaraciones UPDATE y SELECT de la plantilla que puedes editar. Ten en cuenta que las cláusulas WHERE de ambas declaraciones indican que la fila que se 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=NULL,
      firstname='Kena',
      lastname='',
      singerinfo=NULL
    WHERE
      singerid='3';
    SELECT
      *
    FROM
      singers
    WHERE
      singerid='3';
    
  2. Edita la cláusula SET de la sentencia 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.

    Spanner ejecuta las declaraciones. Cuando finaliza, 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

    Los datos actualizados de la tabla Cantantes con una fila actualizada.

    PostgreSQL

    Los datos actualizados de la tabla Cantantes con una fila actualizada.

Borra datos

  1. En la página Datos de la tabla Cantantes, seleccione la casilla de verificación de 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.

    La tabla Cantantes ahora tiene dos filas:

    SQL estándar de Google

    Los datos de la tabla Cantantes actualizados con dos filas; la fila de SingerId 2 ya no existe.

    PostgreSQL

    Los datos de la tabla Cantantes actualizados con dos filas; la fila de SingerId 2 ya no existe.

Ejecuta una consulta

  1. En la página Descripción general de la base de datos, haga clic en Consultar en el menú de navegación.

  2. Haga clic en Nueva pestaña para crear una pestaña de consulta nueva. Luego, ingrese la siguiente consulta en el editor de consultas:

    SQL estándar de Google

    SELECT * FROM Singers;
    

    PostgreSQL

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

    Spanner ejecuta la consulta. Cuando termines, la pestaña Resultados mostrará el resultado de tu consulta:

    SQL estándar de Google

    Los resultados de la consulta.

    PostgreSQL

    Los resultados de la consulta.

¡Felicitaciones! Creaste correctamente una base de datos de Spanner y ejecutaste una instrucción de SQL mediante el editor de consultas.

Realiza una limpieza

Para evitar cargos adicionales en tu cuenta de facturación de Cloud, borra la base de datos y la instancia que creaste. Si borras una instancia, se borrarán de forma automática todas las bases de datos creadas en ella.

Borra la base de datos

  1. En Google Cloud Console, ve a la página Instancias de Spanner.

    Ir a Instancias de Spanner

  2. Haz clic en el nombre de la instancia que tiene la base de datos que deseas borrar, por ejemplo, Instancia de prueba.

  3. Haz clic en el nombre de la base de datos que deseas borrar, por ejemplo, example-db.

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

  5. Ingresa el nombre de la base de datos y haz clic en Borrar para confirmar que deseas borrarla.

Borra la instancia

  1. En Google Cloud Console, ve a la página Instancias de Spanner.

    Ir a Instancias de Spanner

  2. Haz clic en el nombre de la instancia que deseas borrar, por ejemplo, Instancia de prueba.

  3. Haz clic en Borrar instancia.

  4. Ingresa el nombre de la instancia y haz clic en Borrar para confirmar que deseas borrarla.

¿Qué sigue?