Crea y consulta una base de datos con la consola de Google Cloud

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

• Crea una instancia de Spanner.
• Crea 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.

Nota: Para explorar Spanner con una instancia de prueba gratuita de 90 días, consulta Cómo crear una instancia de prueba gratuita de Spanner.

Antes de comenzar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Opcional: La API de Spanner se debe habilitar automáticamente. De lo contrario, habilítala de forma manual:
   Habilita la API de Spanner

7. Para obtener los permisos que necesitas para crear instancias y bases de datos, pídele a tu administrador que te otorgue el rol de IAM de administrador de Cloud Spanner (roles/spanner.admin) en tu proyecto.

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 la consola de Google Cloud, ve a la página Spanner.

   Ir a Spanner

2. Selecciona o crea un proyecto de Google Cloud si aún no lo hiciste.

3. En la página Spanner, haz clic en Crear una instancia aprovisionada.

   Si ya usaste Spanner, verás la página Instancias de Spanner en lugar de la página del producto. Haz clic en Crear instancia.

4. En la página Asigna un nombre a tu instancia, ingresa un nombre para la instancia, como Instancia de prueba.

5. El ID de instancia se ingresa automáticamente según el nombre de la instancia, por ejemplo, como instancia-de-prueba. Cambia la dirección si es necesario. Haga clic en Continuar.

6. En la página Configura tu instancia, conserva la opción predeterminada Regional y selecciona una configuración 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. Haz clic en Continuar.

8. En la página Asignar capacidad de procesamiento, selecciona Unidades de procesamiento (PU) y conserva el valor predeterminado de 1,000 unidades de procesamiento.

9. Haz clic en Crear.

   La consola de Google Cloud muestra la página Descripción general de la instancia que creaste.

Crea una base de datos

1. En la consola de Google Cloud, 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. En el nombre de la base de datos, ingresa un nombre, como example-db.

5. Selecciona un dialecto de la base de datos.

   Para obtener información sobre la compatibilidad con PostgreSQL y orientación para elegir un dialecto, consulta Interfaz de PostgreSQL. Si seleccionaste GoogleSQL, 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:

   

6. Haz clic en Crear.

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

Cree un esquema para su base de datos

Nota: Spanner Studio (antes denominado Query en la consola de Google Cloud) admite operaciones SQL, DML y DDL en un solo editor. Para obtener más información, consulta Administra tus datos con la consola de Google Cloud.

1. En el menú de navegación, haz clic en Spanner Studio.

2. En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.

3. Escribe lo siguiente:

   GoogleSQL

   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 (
     BirthDate  TIMESTAMPTZ,
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo BYTEA
   );
   

4. Haz clic en Ejecutar.

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

   GoogleSQL

   

   PostgreSQL

   

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

Inserta datos y modifícalos

La consola de Google Cloud proporciona una interfaz para insertar, editar y borrar datos.

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

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

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

3. Haga clic en Insert.

   La consola de Google Cloud muestra la página de Spanner Studio de la tabla Singers con una pestaña de consulta nueva que contiene instrucciones INSERT y SELECT que editas para insertar una fila en la tabla Singers y ver el resultado de esa inserción:

   GoogleSQL

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

   Ten en cuenta que PostgreSQL convierte los nombres de las columnas a minúsculas.

4. Edita la cláusula VALUES de la sentencia INSERT y la cláusula WHERE de la sentencia SELECT:

   GoogleSQL

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

   Spanner ejecuta las instrucciones. Cuando termines, la pestaña Resultados indicará que la primera sentencia insertó una fila y proporcionará 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 (Singers) ahora tiene una fila:

   GoogleSQL

   

   PostgreSQL

   

7. Haz clic en Insert para agregar otra fila.

   La consola de Google Cloud vuelve a mostrar la página Spanner Studio 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 sentencia INSERT y la cláusula WHERE de la sentencia SELECT:

   GoogleSQL

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

   Después de que Spanner ejecuta las instrucciones, la pestaña Resultados vuelve a indicar que la primera instrucción insertó una fila.

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

    GoogleSQL

    

    PostgreSQL

    

También, puedes insertar valores de cadena vacía cuando ingreses datos:

1. Haz clic en Insert para agregar una fila.

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

2. Edita la cláusula VALUES de la sentencia INSERT de la plantilla y la cláusula WHERE de la sentencia SELECT:

   GoogleSQL

     -- 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 cadena vacía, '', no un valor NULL.

3. Haz clic en Ejecutar.

   Después de que Spanner ejecuta las sentencias, la pestaña Resultados indica que la primera sentencia insertó una fila.

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

   GoogleSQL

   

   PostgreSQL

   

Editar datos

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

   Spanner muestra la página Spanner Studio con una pestaña nueva que contiene instrucciones UPDATE y SET de plantillas que puedes editar. Ten en cuenta que las cláusulas WHERE de ambas sentencias indican que la fila que se actualizará es la que tiene el valor de clave primaria de 3.

   GoogleSQL

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

   GoogleSQL

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

   Spanner ejecuta las instrucciones. Cuando termines, la pestaña Resultados indicará que la primera sentencia actualizó una fila y proporcionará 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.

   GoogleSQL

   

   PostgreSQL

   

Borra datos

1. En la página Datos de la tabla Cantantes, selecciona la casilla de verificación de la fila con 2 en la primera columna y, luego, haz clic en Borrar.

2. En el diálogo que aparece, haga clic en Confirmar.

   La tabla Singers ahora tiene dos filas:

   GoogleSQL

   

   PostgreSQL

   

Ejecuta una consulta

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

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

   GoogleSQL

   SELECT * FROM Singers;
   

   PostgreSQL

   SELECT * FROM singers;
   

3. Haz clic en Ejecutar.

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

   GoogleSQL

   

   PostgreSQL

   

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

Limpia

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. 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 la consola de Google Cloud, 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. Para confirmar que quieres borrar la base de datos, ingresa su nombre y haz clic en Borrar.

Borra la instancia

1. En la consola de Google Cloud, 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. Para confirmar que quieres borrar la instancia, ingresa su nombre 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 Spanner.
• Obtén más información sobre el lenguaje de definición de datos (DDL) de GoogleSQL.
• Obtén más información sobre los planes de ejecución de consultas.
• Aprende a usar Spanner con C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST o gcloud.