Crea y administra grupos de localidades

Nota: Esta función está disponible en las ediciones Enterprise y Enterprise Plus de Spanner. Para obtener más información, consulta la descripción general de las ediciones de Spanner.

En esta página, se describe cómo crear y administrar grupos de localidad de Spanner. Puedes usar grupos de localidad para definir la política de almacenamiento en niveles para los datos en el esquema de tu base de datos. Para obtener información sobre cómo funciona el almacenamiento en niveles, consulta Almacenamiento en niveles.

Crea un grupo de localidades

Puedes crear un grupo de localidad sin ninguna política de almacenamiento por niveles, o bien crear un grupo de localidad para definir la política de almacenamiento de los datos en el esquema de tu base de datos.

Console

1. Ve a la página Instancias de Spanner en la consola de Google Cloud.

   Instancias

2. Selecciona la instancia en la que deseas usar el almacenamiento en niveles.

3. Selecciona la base de datos en la que deseas usar el almacenamiento en niveles.

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

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

6. Ingresa la sentencia DDL CREATE LOCALITY GROUP con GoogleSQL o PostgreSQL.

   Por ejemplo, puedes ejecutar lo siguiente para crear un grupo de localidad, separate_storage, que almacene las columnas en un archivo separado de los datos del resto de las columnas:

   GoogleSQL

   CREATE LOCALITY GROUP separate_storage;
   

   PostgreSQL

   CREATE LOCALITY GROUP separate_storage;
   

   Por ejemplo, puedes ejecutar lo siguiente para crear un grupo de localidad, ssd_only, que almacene datos en el almacenamiento SSD:

   GoogleSQL

   CREATE LOCALITY GROUP ssd_only OPTIONS (storage='ssd');
   

   PostgreSQL

   CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';
   

   Por ejemplo, puedes ejecutar lo siguiente para crear un grupo de localidad, hdd_only, que almacene datos en el almacenamiento en HDD:

   GoogleSQL

   CREATE LOCALITY GROUP hdd_only OPTIONS (storage='hdd');
   

   PostgreSQL

   CREATE LOCALITY GROUP hdd_only STORAGE 'hdd';
   

7. Haz clic en Ejecutar.

gcloud

Para crear un grupo de localidad con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, puedes ejecutar lo siguiente para crear un grupo de localidad, separate_storage, que almacene las columnas en un archivo separado de los datos del resto de las columnas:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP separate_storage"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP separate_storage"

Por ejemplo, puedes ejecutar lo siguiente para crear un grupo de localidad, ssd_only, que almacene datos en SSD:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP ssd_only OPTIONS (storage='ssd')"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP ssd_only STORAGE 'ssd'"

Por ejemplo, puedes ejecutar lo siguiente para crear un grupo de localidad, hdd_only, que almacene datos en el almacenamiento en HDD:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP hdd_only OPTIONS (storage='hdd')"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP hdd_only STORAGE 'hdd'"

Crea una política basada en la edad para un grupo de localidad

Un grupo de localidad con una política basada en la antigüedad almacena datos más recientes en el almacenamiento SSD durante un tiempo determinado. Una vez transcurrido el tiempo especificado, Spanner migra los datos al almacenamiento en HDD durante su ciclo de compactación normal, que suele ocurrir durante siete días a partir de la hora especificada. Cuando se usa una política de almacenamiento en niveles basada en la antigüedad, la cantidad mínima de tiempo que los datos deben almacenarse en SSD antes de que se transfieran al almacenamiento en HDD es de una hora.

Para crear un grupo de localidad basado en la edad, usa la declaración DDL CREATE LOCALITY GROUP.

Console

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

2. Ingresa la sentencia DDL CREATE LOCALITY GROUP con GoogleSQL o PostgreSQL.

   Por ejemplo, la siguiente sentencia DDL crea un grupo de localidad, spill_to_hdd, que almacena datos en el almacenamiento SSD durante los primeros 10 días y, luego, migra los datos más antiguos al almacenamiento HDD durante el ciclo de compactación normal:

   GoogleSQL

   CREATE LOCALITY GROUP spill_to_hdd
   OPTIONS (storage = 'ssd', ssd_to_hdd_spill_timespan = '10d');
   

   PostgreSQL

   CREATE LOCALITY GROUP spill_to_hdd
   STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d';
   

3. Haz clic en Ejecutar.

gcloud

Para crear un grupo de localidad basado en la edad con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, la siguiente sentencia DDL crea un grupo de localidad spill_to_hdd que almacena datos en SSD durante los primeros 10 días y, luego, migra los datos más antiguos a HDD durante el ciclo de compactación normal.

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP spill_to_hdd OPTIONS (storage='ssd', ssd_to_hdd_spill_timespan='10d')"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE LOCALITY GROUP spill_to_hdd STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d'"

Establece una política de almacenamiento por niveles para tus datos

Después de crear tu grupo de localidades, puedes configurar la política de almacenamiento por niveles para tus datos. La política de almacenamiento en niveles determina el grupo de localidad que usan los datos. Puedes establecer la política de almacenamiento en niveles a nivel de la base de datos, la tabla, la columna o el index secundario. Cada objeto de base de datos hereda su política de almacenamiento en niveles de su elemento superior, a menos que se anule de forma explícita.

Cómo establecer un grupo de localidad a nivel de la base de datos

La política de almacenamiento por niveles predeterminada es que todos los datos se almacenan en el almacenamiento SSD. Puedes cambiar la política de almacenamiento por niveles a nivel de la base de datos alterando el grupo de localidad default. En el caso de las bases de datos con dialecto GoogleSQL, la instrucción DDL ALTER LOCALITY GROUP debe tener default dentro de acentos graves (`default`). Solo debes incluir los acentos graves para el grupo de localidad default.

Console

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

2. Ingresa la sentencia DDL ALTER LOCALITY GROUP con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes instrucciones DDL alteran el grupo de localidad default para usar una política de almacenamiento por niveles basada en la antigüedad. Todos los datos de la base de datos se transfieren al almacenamiento en HDD después de 10 días.

   GoogleSQL

   ALTER LOCALITY GROUP `default` SET OPTIONS (storage = 'ssd', ssd_to_hdd_spill_timespan = '10d');
   

   PostgreSQL

   ALTER LOCALITY GROUP "default" STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d';
   

3. Haz clic en Ejecutar.

gcloud

Para alterar la política de almacenamiento en niveles del grupo de localidad default con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes instrucciones DDL alteran el grupo de localidad default para usar una política de almacenamiento por niveles basada en la antigüedad. Todos los datos de la base de datos se mueven al almacenamiento en HDD después de 10 días.

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP `default` SET OPTIONS (storage = 'ssd', ssd_to_hdd_spill_timespan = '10d');"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP "default" STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d';"

Cómo establecer un grupo de localidad a nivel de la tabla

Puedes establecer una política de almacenamiento en niveles a nivel de la tabla para tus datos que anule la política de almacenamiento en niveles a nivel de la base de datos.

Console

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

2. Ingresa la sentencia DDL CREATE TABLE con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes declaraciones DDL crean una tabla, Singers, que usa el grupo de localidad ssd_only:

   GoogleSQL

   CREATE TABLE Singers (
     SingerId   INT64 NOT NULL,
     FirstName  STRING(1024),
     LastName   STRING(1024),
     SingerInfo BYTES(MAX)
   ) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');
   

   PostgreSQL

   CREATE TABLE Singers (
     SingerId   bigint PRIMARY KEY,
     FirstName  varchar(1024),
     LastName   varchar(1024),
     SingerInfo bytea
   ) LOCALITY GROUP ssd_only;
   

3. Haz clic en Ejecutar.

gcloud

Para establecer una política de almacenamiento por niveles a nivel de la tabla con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes instrucciones DDL crean una tabla, Singers, que usa el grupo de localidad ssd_only.

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Singers ( SingerId   INT64 NOT NULL, \
        FirstName  STRING(1024), \
        LastName   STRING(1024), \
        SingerInfo BYTES(MAX) \
        ) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Singers ( \
        SingerId bigint PRIMARY KEY, \
        FirstName  varchar(1024), \
        LastName   varchar(1024), \
        SingerInfo bytea \
        ) LOCALITY GROUP ssd_only;"

Establece una política de almacenamiento en niveles de anulación a nivel de la columna

Puedes establecer una política de almacenamiento en niveles de anulación a nivel de la columna para tus datos.

Console

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

2. Ingresa la sentencia DDL CREATE TABLE con una política de almacenamiento en niveles de anulación a nivel de la columna con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes instrucciones DDL crean una tabla Singers que usa el grupo de localidad ssd_only. Sin embargo, la columna Awards anula este grupo de localidad a nivel de la tabla y usa el grupo de localidad spill_to_hdd como su política de almacenamiento en niveles:

   GoogleSQL

   CREATE TABLE Singers (
     SingerId   INT64 NOT NULL,
     FirstName  STRING(1024),
     LastName   STRING(1024),
     Awards     ARRAY<STRING(MAX)> OPTIONS (locality_group = 'spill_to_hdd')
   ) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');
   

   PostgreSQL

   CREATE TABLE Singers (
     SingerId   bigint PRIMARY KEY,
     FirstName  varchar(1024),
     LastName   varchar(1024),
     Awards     varchar[] LOCALITY GROUP spill_to_hdd
   ) LOCALITY GROUP ssd_only;
   

3. Haz clic en Ejecutar.

gcloud

Para establecer una política de almacenamiento en niveles de anulación a nivel de la columna con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes instrucciones DDL crean una tabla Singers que usa el grupo de localidad ssd_only. Sin embargo, la columna Awards supera esta política de almacenamiento en niveles a nivel de la tabla y usa el grupo de localidad spill_to_hdd como su política de almacenamiento en niveles:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Singers ( \
      SingerId   INT64 NOT NULL, \
      FirstName  STRING(1024), \
      LastName   STRING(1024), \
      Awards     ARRAY<STRING(MAX)> OPTIONS (locality_group = 'spill_to_hdd') \
    ) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');" \

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Singers ( \
      SingerId   bigint PRIMARY KEY, \
      FirstName  varchar(1024), \
      LastName   varchar(1024), \
      Awards     varchar[] LOCALITY GROUP spill_to_hdd \
    ) LOCALITY GROUP ssd_only;"

Configura una política de almacenamiento en niveles de anulación a nivel del índice secundario

Puedes establecer una política de almacenamiento en niveles de anulación secundaria a nivel del índice para tus datos.

Console

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

2. Ingresa la sentencia DDL CREATE INDEX con una política de almacenamiento en niveles de anulación a nivel del índice secundario con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes instrucciones DDL crean una tabla Singers que usa el grupo de localidad ssd_only. La base de datos también tiene un índice secundario en todos los Singers de la base de datos por su nombre y apellido. El índice SingersByFirstLastName anula la política de almacenamiento en niveles a nivel de la tabla y usa el grupo de localidad spill_to_hdd como su política de almacenamiento en niveles:

   GoogleSQL

   CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName)
   OPTIONS (locality_group = 'spill_to_hdd');
   

   PostgreSQL

   CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName)
   LOCALITY GROUP spill_to_hdd;
   

3. Haz clic en Ejecutar.

gcloud

Para establecer una política de almacenamiento en niveles con anulación a nivel del índice secundario con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes instrucciones DDL crean una tabla Singers que usa el grupo de localidad ssd_only. La base de datos también crea un índice secundario en todos los Singers de la base de datos por su nombre y apellido. El índice SingersByFirstLastName anula la política de almacenamiento en niveles a nivel de la tabla y usa el grupo de localidad spill_to_hdd como su política de almacenamiento en niveles:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName) \
    OPTIONS (locality_group = 'spill_to_hdd');"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName) \
    LOCALITY GROUP spill_to_hdd;"

Cómo establecer un grupo de localidad a nivel de la columna

Puedes establecer un grupo de localidad a nivel de la columna para tus datos, incluso si el grupo de localidad no tiene una política de almacenamiento por niveles. La lectura de datos de esta columna es más rápida que la lectura de datos agrupados con otras columnas.

Console

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

2. Ingresa la sentencia DDL CREATE TABLE que asigna la columna a un grupo de localidad con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes sentencias DDL crean una tabla Songs con una columna LyricsCompressed que se almacena por separado en el grupo de localidad hdd_only:

   GoogleSQL

   CREATE TABLE Songs (
     SingerId INT64 NOT NULL,
     SongId INT64 NOT NULL,
     Title STRING(MAX),
     Description STRING(MAX),
     LyricsCompressed BYTES(MAX) OPTIONS (locality_group = 'hdd_only')
   ) PRIMARY KEY (SingerId, SongId),
     INTERLEAVE IN PARENT Singers ON DELETE CASCADE,
     OPTIONS (locality_group = 'ssd_only');
   

   PostgreSQL

   CREATE TABLE Songs (
     SingerId BIGINT NOT NULL,
     SongId BIGINT NOT NULL,
     Title VARCHAR,
     Description TEXT,
     LyricsCompressed BYTEA LOCALITY GROUP hdd_only,
     PRIMARY KEY (SingerId, SongId)
   ) LOCALITY GROUP ssd_only INTERLEAVE IN PARENT Singers ON DELETE CASCADE;
   

3. Haz clic en Ejecutar.

gcloud

Para establecer un grupo de localidad a nivel de la columna para tus datos con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes sentencias DDL crean una tabla Songs con una columna LyricsCompressed que se almacena por separado en el grupo de localidad hdd_only:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Songs ( \
      SingerId INT64 NOT NULL, \
      SongId INT64 NOT NULL, \
      Title STRING(MAX), \
      Description STRING(MAX),
      LyricsCompressed BYTES(MAX) OPTIONS (locality_group = 'hdd_only') \
    ) PRIMARY KEY (SingerId, SongId), \
      INTERLEAVE IN PARENT Singers ON DELETE CASCADE, \
      OPTIONS (locality_group = 'ssd_only');"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE TABLE Songs ( \
      SingerId BIGINT NOT NULL, \
      SongId BIGINT NOT NULL, \
      Title VARCHAR, \
      Description TEXT, \
      LyricsCompressed BYTEA LOCALITY GROUP hdd_only, \
      PRIMARY KEY (SingerId, SongId) \
    ) LOCALITY GROUP ssd_only INTERLEAVE IN PARENT Singers ON DELETE CASCADE;

Cómo mover datos entre opciones de almacenamiento

Puedes mover datos entre el almacenamiento SSD y HDD. La transferencia de datos puede tardar hasta siete días. Para supervisar el progreso del traslado, consulta la tabla SPANNER_SYS.TABLE_SIZES_STATS_1HOUR integrada para verificar el uso del almacenamiento en HDD y SSD de cada tabla de tu base de datos. También puedes supervisar el uso de almacenamiento con la métrica spanner.googleapis.com/instance/storage/used_bytes de Cloud Monitoring para mostrar el desglose de SSD y HDD de tu base de datos o instancia. Para obtener más información, consulta Observabilidad del almacenamiento en niveles.

Cómo mover datos del almacenamiento SSD al HDD

Para mover datos del almacenamiento de SSD al de HDD, puedes crear un grupo de localidad nuevo con una política de almacenamiento en niveles basada en la antigüedad o cambiar la política de almacenamiento en niveles de un grupo de localidad existente. Mover datos de SSD a HDD puede tardar hasta siete días. Para obtener más información, consulta Cómo crear una política basada en la edad para el grupo de localidad o Cómo cambiar la opción de almacenamiento.

Cómo mover datos del almacenamiento HDD al SSD

Para mover datos del almacenamiento en HDD al almacenamiento en SSD, puedes cambiar la opción de almacenamiento de un grupo de localidad existente o alterar el grupo de localidad que usa la tabla. Mover datos de SSD a HDD puede tardar hasta siete días.

Cómo alterar el grupo de localidad que usa una tabla

Para alterar el grupo de localidad que usa una tabla, configura un grupo de localidad nuevo o diferente en las opciones de la tabla.

Console

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

2. Ingresa la sentencia DDL ALTER TABLE que cambia el grupo de localidad que usa la tabla con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes instrucciones DDL alteran el grupo de localidad que usa la tabla, Singers, a spill_to_hdd:

   GoogleSQL

   ALTER TABLE Singers SET OPTIONS (locality_group = 'spill_to_hdd');
   

   PostgreSQL

   ALTER TABLE Singers SET LOCALITY GROUP spill_to_hdd;
   

3. Haz clic en Ejecutar.

gcloud

Para alterar el grupo de localidad que usa una tabla con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes instrucciones DDL alteran el grupo de localidad que usa la tabla, Singers, a spill_to_hdd:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER TABLE Singers SET OPTIONS(locality_group = 'spill_to_hdd');"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER TABLE Singers SET LOCALITY GROUP spill_to_hdd;"

Cómo alterar el grupo de localidad que usa la columna de una tabla

Puedes alterar el grupo de localidad que usa la columna de una tabla configurando el grupo de localidad en las opciones de la columna.

Console

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

2. Ingresa la sentencia DDL ALTER TABLE que cambia el grupo de localidad que usa la tabla con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes instrucciones DDL alteran el grupo de localidad que usa la columna de la tabla, LastName, a spill_to_hdd:

   GoogleSQL

   ALTER TABLE Singers
   ALTER COLUMN LastName SET OPTIONS(locality_group = 'spill_to_hdd');
   

   PostgreSQL

   ALTER TABLE Singers
   ALTER COLUMN LastName SET LOCALITY GROUP spill_to_hdd;
   

3. Haz clic en Ejecutar.

gcloud

Para alterar el grupo de localidad que usa una tabla con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes instrucciones DDL alteran el grupo de localidad que usa la columna de la tabla, LastName, a spill_to_hdd:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER TABLE Singers ALTER COLUMN LastName SET OPTIONS(locality_group = 'spill_to_hdd');"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER TABLE Singers ALTER COLUMN SET LOCALITY GROUP spill_to_hdd;"

Cómo modificar un grupo de localidades

Para alterar un grupo de localidad, cambia su opción de almacenamiento o cambia su política basada en la edad.

Cómo cambiar la opción de almacenamiento

Puedes cambiar la opción de almacenamiento de un grupo de localidad de SSD a HDD o de HDD a SSD.

Console

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

2. Ingresa la sentencia DDL ALTER LOCALITY GROUP con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes sentencias DDL cambian la opción de almacenamiento del grupo de localidad, separate_storage, a HDD:

   GoogleSQL

   ALTER LOCALITY GROUP separate_storage SET OPTIONS (storage='hdd');
   

   PostgreSQL

   ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';
   

3. Haz clic en Ejecutar.

gcloud

Para cambiar la opción de almacenamiento de un grupo de localidad con el comando de gcloud CLI, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes sentencias DDL cambian la opción de almacenamiento del grupo de localidad, separate_storage, a HDD:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP separate_storage SET OPTIONS (storage = 'hdd');"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';"

Cambia la política basada en la antigüedad

Para cambiar la política basada en la antigüedad de un grupo de localidad, puedes extender o acortar el tiempo que los datos se almacenan en el SSD antes de que se transfieran al almacenamiento en HDD.

Console

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

2. Ingresa la sentencia DDL ALTER LOCALITY GROUP con GoogleSQL o PostgreSQL.

   Por ejemplo, las siguientes instrucciones DDL cambian la política basada en la antigüedad del grupo de localidad, spill_to_hdd, ya que extienden el tiempo durante el cual los datos se almacenan en SSD a 20 días:

   GoogleSQL

   ALTER LOCALITY GROUP spill_to_hdd SET OPTIONS (ssd_to_hdd_spill_timespan = '20d');
   

   PostgreSQL

   ALTER LOCALITY GROUP spill_to_hdd SSD_TO_HDD_SPILL_TIMESPAN '20d';
   

3. Haz clic en Ejecutar.

gcloud

Para cambiar la política basada en la edad de un grupo de localidades con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, las siguientes instrucciones DDL cambian la política basada en la antigüedad del grupo de localidad, spill_to_hdd, ya que extienden el tiempo durante el cual los datos se almacenan en SSD a 20 días:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP spill_to_hdd SET OPTIONS (ssd_to_hdd_spill_timespan = '20d');"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="ALTER LOCALITY GROUP spill_to_hdd SSD_TO_HDD_SPILL_TIMESPAN '20d';"

Cómo borrar un grupo de localidades

No puedes borrar un grupo de localidades si contiene datos. Primero debes mover todos los datos que se encuentran en el grupo de localidad a otro grupo de localidad. Para obtener más información, consulta Cómo alterar el grupo de localidad que usa la tabla.

Console

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

2. Ingresa la sentencia DDL DROP LOCALITY GROUP con GoogleSQL o PostgreSQL.

   Por ejemplo, puedes ejecutar lo siguiente para descartar un grupo de localidad ssd_only:

   GoogleSQL

   DROP LOCALITY GROUP ssd_only;
   

   PostgreSQL

   DROP LOCALITY GROUP ssd_only;
   

3. Haz clic en Ejecutar.

gcloud

Para descartar un grupo de localidades con el comando de la CLI de gcloud, usa gcloud spanner databases ddl update.

Por ejemplo, para descartar el grupo de localidad ssd_only, ejecuta lo siguiente:

GoogleSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="DROP LOCALITY GROUP ssd_only"

PostgreSQL

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="DROP LOCALITY GROUP ssd_only"

¿Qué sigue?

• Obtén más información sobre el almacenamiento en niveles.
• Obtén más información sobre los grupos de localidades.
• Obtén más información para optimizar las consultas con la baja de predicados de marca de tiempo.