Objetivos
En este instructivo, se explican los siguientes pasos mediante la herramienta de línea de comandos de gcloud.
- Crea una instancia, una base de datos y un esquema de Spanner
- Escribe datos en la base de datos y ejecutar consultas de SQL
- Limpia la base de datos y la instancia
Para obtener la referencia gcloud spanner
completa, consulta gcloud spanner.
Precios
En este instructivo, se usa Spanner, que es un componente facturable de en Google Cloud. Para obtener información sobre el costo de usar Spanner, consulta Precios.
Antes de comenzar
- Completa los pasos descritos en Instalar gcloud CLI y configurar la API de Cloud Spanner que incluye cómo crear y configurar un proyecto predeterminado de Google Cloud, habilitar de Google Cloud, habilitando la API de Cloud Spanner y configurando OAuth 2.0 para credenciales de autenticación para usar la API de Cloud Spanner.
En particular, asegúrate de ejecutar gcloud auth application-default
login
para configurar tu
entorno de desarrollo local con credenciales de autenticación.
Configura un proyecto predeterminado
Si aún no lo hiciste, configura el ID de un proyecto de Google Cloud como proyecto predeterminado para Google Cloud CLI:
gcloud config set project PROJECT_ID
Si no configuras el proyecto predeterminado, debes pasar --project
PROJECT_ID
a cada uno de los siguientes comandos como el primer argumento para gcloud spanner
. Por ejemplo:
gcloud spanner --project=PROJECT_ID instance-configs list
Instancias
Cuando usas Spanner por primera vez, debes crear una instancia, que es un de los recursos que usan las bases de datos de Spanner. Cuando crear una instancia, tú eliges dónde se almacenan los datos y la cantidad capacidad de procesamiento que tiene la instancia.
Instancias y configuraciones de instancias
Para crear una instancia, debes seleccionar una de Terraform, que es como un plano para tu instancia que define la ubicación geográfica y la replicación de tus datos de Spanner.
Muestra configuraciones de instancias
Cuando creas una instancia, especificas una configuración de instancia, que define la ubicación geográfica y la replicación de las bases de datos en esa instancia. Puedes elegir una configuración regional, que almacena los datos en una una región doble, que almacena datos en dos regiones del mismo país, o una configuración multirregional, que distribuye los datos entre múltiples regiones. Para obtener más información, consulta la Descripción general de las instancias.
A fin de ver el conjunto de configuraciones de instancias disponibles para tu proyecto, sigue estos pasos:
gcloud spanner instance-configs list
Deberías ver una lista de configuraciones regionales, birregionales y multirregionales.
Crea una instancia
Para crear una instancia llamada test-instance
con el nombre comercial My Instance
mediante la configuración de instancia regional regional-us-central1
con 1 nodo, sigue estos pasos:
gcloud spanner instances create test-instance --config=regional-us-central1 \ --description="My Instance" --nodes=1
En el comando anterior, el nombre de la instancia se configura como test-instance
y --description
establece el nombre comercial de la instancia. Ambos valores deben ser únicos dentro de un proyecto de Google Cloud Platform.
Establece la instancia predeterminada
Puedes configurar la instancia predeterminada que usa Spanner cuando aún no lo has hecho especificado una instancia en tu comando. Para configurar la instancia predeterminada, sigue estos pasos:
gcloud config set spanner/instance test-instance
Crea una base de datos
Crea una base de datos con el nombre example-db
. El dialecto de la base de datos predeterminado es GoogleSQL.
GoogleSQL
gcloud spanner databases create example-db
PostgreSQL
gcloud spanner databases create example-db --database-dialect=POSTGRESQL
Actualiza el esquema
Usa el lenguaje de definición de datos de Spanner (DDL) para crear, modificar o descartar tablas, y crear o descartar índices.
Creemos dos tablas:
GoogleSQL
gcloud spanner databases ddl update example-db \ --ddl='CREATE TABLE Singers ( SingerId INT64 NOT NULL, FirstName STRING(1024), LastName STRING(1024), SingerInfo BYTES(MAX) ) PRIMARY KEY (SingerId)' gcloud spanner databases ddl update example-db \ --ddl='CREATE TABLE Albums ( SingerId INT64 NOT NULL, AlbumId INT64 NOT NULL, AlbumTitle STRING(MAX)) PRIMARY KEY (SingerId, AlbumId), INTERLEAVE IN PARENT Singers ON DELETE CASCADE'
PostgreSQL
gcloud spanner databases ddl update example-db \ --ddl='CREATE TABLE Singers ( SingerId bigint NOT NULL, FirstName varchar(1024), LastName varchar(1024), SingerInfo bytea, PRIMARY KEY (SingerId) )' gcloud spanner databases ddl update example-db \ --ddl='CREATE TABLE Albums ( SingerId bigint NOT NULL, AlbumId bigint NOT NULL, AlbumTitle varchar, PRIMARY KEY (SingerId, AlbumId) ) INTERLEAVE IN PARENT Singers ON DELETE CASCADE'
Para comprobar el progreso de la operación, usa
gcloud spanner operations describe
Este comando requiere el ID de operación.
Obtén el ID de operación:
gcloud spanner operations list --instance="test-instance" \ --database=DATABASE-NAME --type=DATABASE_UPDATE_DDL
Reemplaza DATABASE-NAME por el nombre de la base de datos.
Ejecuta gcloud spanner operations describe
:
gcloud spanner operations describe \ --instance="test-instance" \ --database="example-db" \ projects/PROJECT-NAME/instances/test-instance/databases/example-db/operations/OPERATION-ID
Reemplaza lo siguiente:
- PROJECT-NAME: Es el nombre del proyecto.
- OPERATION-ID: Es el ID de la operación que deseas. de verificación.
El resultado es similar al siguiente:
done: true metadata: ... progress: - endTime: '2022-03-01T00:28:06.691403Z' progressPercent: 100 startTime: '2022-03-01T00:28:04.221401Z' - endTime: '2022-03-01T00:28:17.624588Z' startTime: '2022-03-01T00:28:06.691403Z' progressPercent: 100 ...
Escribe datos
Agrega algunos datos de muestra a la base de datos
GoogleSQL
gcloud spanner rows insert --database=example-db \ --table=Singers \ --data=SingerId=1,FirstName=Marc,LastName=Richards gcloud spanner rows insert --database=example-db \ --table=Singers \ --data=SingerId=2,FirstName=Catalina,LastName=Smith gcloud spanner rows insert --database=example-db \ --table=Singers \ --data=SingerId=3,FirstName=Alice,LastName=Trentor gcloud spanner rows insert --database=example-db \ --table=Albums \ --data=SingerId=1,AlbumId=1,AlbumTitle="Total Junk" gcloud spanner rows insert --database=example-db \ --table=Albums \ --data=SingerId=2,AlbumId=1,AlbumTitle="Green" gcloud spanner rows insert --database=example-db \ --table=Albums \ --data=^:^SingerId=2:AlbumId=2:AlbumTitle="Go, Go, Go"
De forma predeterminada, se utiliza una coma para delimitar los elementos en las listas. En el último comando insert, especificamos un dos puntos (^:^
) como delimitador para poder usar una coma en el título del álbum.
PostgreSQL
gcloud spanner databases execute-sql example-db \ --sql="INSERT INTO Singers (SingerId, FirstName, LastName) VALUES (1, 'Marc', 'Richards')" gcloud spanner databases execute-sql example-db \ --sql="INSERT INTO Singers (SingerId, FirstName, LastName) VALUES (2, 'Catalina', 'Smith')" gcloud spanner databases execute-sql example-db \ --sql="INSERT INTO Singers (SingerId, FirstName, LastName) VALUES (3, 'Alice', 'Trentor')" gcloud spanner databases execute-sql example-db \ --sql="INSERT INTO Albums (SingerId, AlbumId, AlbumTitle) VALUES (1, 1, 'Total Junk')" gcloud spanner databases execute-sql example-db \ --sql="INSERT INTO Albums (SingerId, AlbumId, AlbumTitle) VALUES (2, 1, 'Green')" gcloud spanner databases execute-sql example-db \ --sql="INSERT INTO Albums (SingerId, AlbumId, AlbumTitle) VALUES (2, 2, 'Go, Go, Go')"
Consulta datos mediante SQL
Ejecuta una consulta en la línea de comandos:
gcloud spanner databases execute-sql example-db \ --sql='SELECT SingerId, AlbumId, AlbumTitle FROM Albums'
Para obtener la referencia de SQL de Spanner, consulta Sintaxis de consultas para GoogleSQL o Sintaxis de consultas para PostgreSQL.
Para ver una lista de marcas que puedes usar con el comando execute-sql
, consulta gcloud spanner databases execute-sql.
Limpieza
Para evitar que se apliquen cargos adicionales a tu cuenta de Google Cloud por los recursos que se usaron en este instructivo, descarta la base de datos y borra la instancia que creaste.
Desconectar una base de datos
Para borrar una instancia existente, sigue estos pasos:
gcloud spanner databases delete example-db
Borra una instancia
Para borrar una instancia existente, sigue estos pasos:
gcloud spanner instances delete test-instance
Ten en cuenta que la eliminación de una instancia también descarta todas las bases de datos de esa instancia. La eliminación de una instancia no es reversible.