En esta página, se describe cómo crear y administrar posiciones de datos en Spanner.
Para obtener más información sobre cómo funciona la partición geográfica, consulta el Descripción general de la partición geográfica.
Crea una posición de datos
Después de crear las particiones de Spanner y bases de datos, crea tu posición.
Console
Ve a la página Instancias en la consola de Google Cloud.
Selecciona la instancia con las particiones creadas por el usuario.
Selecciona la base de datos en la que quieras particionar los datos.
En el menú de navegación, haz clic en Spanner Studio.
En la página Spanner Studio, haz clic en
Nueva pestaña o usa la pestaña del editor vacía.Ingresa la sentencia DDL
CREATE PLACEMENT
(GoogleSQL, PostgreSQL).Por ejemplo, puedes ejecutar lo siguiente para crear una tabla de posiciones
europeplacement
en la particióneurope-partition
:GoogleSQL
CREATE PLACEMENT `europeplacement` OPTIONS (instance_partition="europe-partition");
PostgreSQL
CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition');
Opcional: También puedes usar el panel Explorador de objetos para ver, buscar y interactuar con tus objetos de posición. Para obtener más información, consulta Explora tus datos.
Haz clic en Ejecutar.
gcloud
Para crear una posición con el comando de gcloud CLI, usa
gcloud spanner databases ddl update
Por ejemplo, crea una posición en la partición europe-partition
:
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT europeplacement OPTIONS (instance_partition='europe-partition')"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition')"
Borra una posición de datos
No puedes borrar una posición. Debes borrar la base de datos para eliminar la posición y sus datos asociados. Para obtener más información, consulta Borra una base de datos.
Cómo crear una tabla con una clave de posición
Console
- En el menú de navegación, haz clic en Spanner Studio.
- En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.
Ingresa el
CREATE TABLE
(GoogleSQL, PostgreSQL).Por ejemplo, puedes crear una tabla
Singers
que use una clave de posición para particionar los datos de cantantes:GoogleSQL
CREATE TABLE Singers ( SingerId INT64 NOT NULL, SingerName STRING(MAX) NOT NULL, ... Location STRING(MAX) NOT NULL PLACEMENT KEY ) PRIMARY KEY (SingerId);
PostgreSQL
CREATE TABLE Singers ( SingerId bigint PRIMARY KEY, SingerName varchar(1024), ... Location varchar(1024) NOT NULL PLACEMENT KEY );
gcloud
Para crear una tabla, usa gcloud spanner databases ddl update
.
Por ejemplo, puedes crear una tabla Singers
que use
Una clave de posición para particionar los datos del cantante:
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE TABLE Singers ( SingerId INT64 NOT NULL, SingerName STRING(MAX) NOT NULL, Location STRING(MAX) NOT NULL PLACEMENT KEY ) PRIMARY KEY (SingerId);"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE TABLE Singers ( SingerId bigint PRIMARY KEY, SingerName varchar(1024), Location varchar(1024) NOT NULL PLACEMENT KEY );"
Cómo editar una tabla con una clave de posición
No puedes descartar una clave de posición de una tabla. Tampoco puedes agregar una clave de posición
a una tabla después de haberla creado. Sin embargo, puedes usar la sentencia DDL ALTER TABLE
(GoogleSQL, PostgreSQL) para cambiar otros campos de la tabla, por ejemplo, agregando y quitando columnas de clave que no sean de posición.
Cómo borrar una tabla con una clave de posición
Antes de borrar una tabla con una clave de posición, primero debes hacer lo siguiente:
- Borra todas las filas de la tabla de posiciones.
- Espera a que se apruebe el
version_retention_period
de la base de datos. Para obtener más información, consulta Recuperación de un momento determinado. Luego, sigue estos pasos:
Console
- En el menú de navegación, haz clic en Spanner Studio.
- En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.
Ingresa el
DROP TABLE
(GoogleSQL, PostgreSQL).Por ejemplo, descarta la tabla
Singers
:DROP TABLE Singers;
gcloud
Para eliminar una tabla, usa
gcloud spanner databases ddl update
Por ejemplo, descarta la tabla Singers
:
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="DROP TABLE Singers"
Insertar una fila en una tabla de posiciones
Console
- En el menú de navegación, haz clic en Spanner Studio.
- En la página de Spanner Studio, haz clic en Nueva pestaña o usa la barra Editor.
Ingresa el
INSERT INTO
(GoogleSQL, PostgreSQL).Por ejemplo, agrega un cantante, Marc Richards, a la tabla
Singers
y divídelo eneuropeplacement
:INSERT INTO Singers(SingerId, SingerName, Location) VALUES (1, 'Marc Richards', 'europeplacement')
gcloud
Para escribir datos en una tabla, usa
gcloud spanner rows insert
Por ejemplo, agrega un cantante, Marc Richards, a la tabla Singers
y divídelo en europeplacement
:
gcloud spanner rows insert --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,SingerName='Marc Richards',Location='europeplacement'
Actualizar una fila en una tabla de posiciones
Console
- En el menú de navegación, haz clic en Spanner Studio.
- En la página Spanner Studio, haz clic en Nueva pestaña o usa la pestaña del editor vacía.
Usa DML o mutaciones para actualizar los datos en una tabla de posiciones.
Por ejemplo, actualiza el nombre de
singerid=1
en la tablaSingers
aCatalina Smith
:UPDATE Singers s SET s.name='Catalina Smith' WHERE s.id=1;
gcloud
Para actualizar datos en una tabla de posiciones,
usa gcloud spanner rows update
.
Por ejemplo, actualiza el nombre de singerid=1
en la tabla Singers
a
Catalina Smith
:
gcloud spanner rows update --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,SingerName='Catalina Smith'
Cómo mover una fila en una tabla de posiciones
Console
- Si aún no lo hiciste, crea una partición y una ubicación nuevas.
- En el menú de navegación, haz clic en Spanner Studio.
- En la página de Spanner Studio, haz clic en Nueva pestaña o usa la barra Editor.
Usa DML o mutaciones para mover los datos a la partición nueva.
Por ejemplo, mueve
singerid=1
en la tablaSingers
aasiaplacement
:UPDATE Singers s SET s.location='asiaplacement' WHERE s.id=1;
gcloud
Después de crear la partición y la ubicación a la que deseas mover tus datos, usa gcloud spanner rows update
.
Por ejemplo, mueve singerid=1
de la tabla Singers
a asiaplacement
:
gcloud spanner rows update --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,Location='asiaplacement'
Borra una fila de una tabla de posiciones
Console
- En el menú de navegación, haz clic en Spanner Studio.
- En la página de Spanner Studio, haz clic en Nueva pestaña o usa la barra Editor.
Usa DML o mutaciones para borrar datos.
Por ejemplo, borra
singerid=1
en la tablaSingers
:DELETE FROM Singers s WHERE s.id=1;
gcloud
Para borrar datos, usa gcloud spanner rows delete
.
Por ejemplo, borra singerid=1
en la tabla Singers
:
gcloud spanner rows delete --table=Singers --database=example-db \
--instance=test-instance --keys=1
Consultar datos en una tabla de posiciones
Console
- En el menú de navegación, haz clic en Spanner Studio.
- En la página de Spanner Studio, haz clic en Nueva pestaña o usa la barra Editor.
Ejecuta tu consulta.
Por ejemplo, consulta la tabla
Singers
:SELECT * FROM Singers s WHERE s.SingerId=1;
gcloud
Para consultar datos, usa gcloud spanner databases execute-sql
.
Por ejemplo, consulta la tabla Singers
:
gcloud spanner databases execute-sql example-db \
--sql='SELECT * FROM Singers s WHERE s.SingerId=1'
¿Qué sigue?
Obtén más información sobre la partición geográfica.
Obtén más información sobre cómo crear y administrar particiones.