Criar e gerenciar grupos de localidades

Esta página descreve como criar e gerenciar grupos de localidade do Spanner. É possível usar grupos de localidade para definir a política de armazenamento em camadas para dados no esquema do banco de dados. Para saber como o armazenamento em camadas funciona, consulte Armazenamento em camadas.

Criar um grupo de localidades

É possível criar um grupo de localidades sem nenhuma política de armazenamento em camadas ou criar um grupo de localidades para definir a política de armazenamento de dados no esquema do banco de dados.

Console

  1. Acesse a página Instâncias do Spanner no console do Google Cloud.

    Instâncias

  2. Selecione a instância em que você quer usar o armazenamento em camadas.

  3. Selecione o banco de dados em que você quer usar o armazenamento em camadas.

  4. No menu de navegação, clique em Spanner Studio.

  5. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  6. Insira a instrução DDL CREATE LOCALITY GROUP usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, você pode executar o seguinte para criar um grupo de localidades, separate_storage, que armazena colunas em um arquivo separado dos dados para o restante das colunas:

    GoogleSQL 

    CREATE LOCALITY GROUP separate_storage;

    PostgreSQL 

    CREATE LOCALITY GROUP separate_storage;

    Por exemplo, você pode executar o comando a seguir para criar um grupo de localidades, ssd_only, que armazena dados no armazenamento SSD:

    GoogleSQL 

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

    PostgreSQL 

    CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';

    Por exemplo, você pode executar o seguinte para criar um grupo de localidades, hdd_only, que armazena dados no armazenamento de HDD:

    GoogleSQL 

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

    PostgreSQL 

    CREATE LOCALITY GROUP hdd_only STORAGE 'hdd';

  7. Clique em Executar.

gcloud

Para criar um grupo de localidades com o comando gcloud CLI, use gcloud spanner databases ddl update.

Por exemplo, você pode executar o seguinte para criar um grupo de localidades, separate_storage, que armazena colunas em um arquivo separado dos dados para o restante das colunas:

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 exemplo, execute o comando a seguir para criar um grupo de localidades, ssd_only, que armazena dados no 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 exemplo, você pode executar o seguinte para criar um grupo de localidades, hdd_only, que armazena dados no armazenamento de 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'"

Criar uma política baseada na idade para um grupo de localidades

Um grupo de localidade com uma política baseada na idade armazena dados mais recentes no armazenamento SSD por um tempo especificado. Depois que o tempo especificado passa, o Spanner migra os dados para o armazenamento de HDD durante o ciclo de compactação normal, que normalmente ocorre ao longo de sete dias a partir do tempo especificado. Ao usar uma política de armazenamento em camadas com base na idade, o tempo mínimo que os dados precisam ser armazenados no SSD antes de serem movidos para o armazenamento em disco rígido é de uma hora.

Para criar um grupo de localidades com base na idade, use a instrução DDL CREATE LOCALITY GROUP.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL CREATE LOCALITY GROUP usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, a instrução DDL a seguir cria um grupo de localidade, spill_to_hdd, que armazena dados no armazenamento SSD nos primeiros 10 dias e, em seguida, migra os dados mais antigos para o armazenamento HDD durante o ciclo de compactação 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. Clique em Executar.

gcloud

Para criar um grupo de localidades com base na idade com o comando gcloud CLI, use gcloud spanner databases ddl update.

Por exemplo, a instrução DDL a seguir cria um grupo de localidade spill_to_hdd que armazena dados em SSD nos primeiros 10 dias e, em seguida, migra os dados mais antigos para HDD durante o ciclo de compactação 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'"

Definir uma política de armazenamento em camadas para seus dados

Depois de criar o grupo de localidades, você pode definir a política de armazenamento em camadas para seus dados. A política de armazenamento em camadas determina o grupo de localidade que os dados usam. É possível definir a política de armazenamento em camadas no nível do banco de dados, da tabela, da coluna ou do índice secundário. Cada objeto de banco de dados herda a política de armazenamento em camadas do pai, a menos que seja substituído explicitamente.

Definir um grupo de localidades no nível do banco de dados

A política de armazenamento em camadas padrão é que todos os dados sejam armazenados em SSD. É possível mudar a política de armazenamento em camadas no nível do banco de dados alterando o grupo de localidade default. Para bancos de dados com dialeto GoogleSQL, a instrução DDL ALTER LOCALITY GROUP precisa ter default entre chaves (`default`). Você só precisa incluir as chaves para o grupo de localidade default.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL ALTER LOCALITY GROUP usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as instruções DDL a seguir alteram o grupo de localidade default para usar uma política de armazenamento em camadas com base na idade. Todos os dados no banco de dados são movidos para o armazenamento de disco rígido após 10 dias.

    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. Clique em Executar.

gcloud

Para alterar a política de armazenamento em camadas do grupo de localidades default com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as instruções DDL a seguir alteram o grupo de localidade default para usar uma política de armazenamento em camadas com base na idade. Todos os dados no banco de dados são movidos para o armazenamento de HDD após 10 dias.

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

Definir um grupo de localidades no nível da tabela

É possível definir uma política de armazenamento em camadas no nível da tabela para seus dados que substitui a política de armazenamento em camadas no nível do banco de dados.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL CREATE TABLE usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as instruções DDL a seguir criam uma tabela, Singers, que usa o grupo de localidade 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. Clique em Executar.

gcloud

Para definir uma política de armazenamento em camada no nível da tabela com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as instruções DDL a seguir criam uma tabela, Singers, que usa o grupo de localidade 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;"

Definir uma política de armazenamento em camadas de substituição no nível da coluna

É possível definir uma política de armazenamento em camadas de substituição no nível da coluna para seus dados.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL CREATE TABLE com uma política de armazenamento em camadas de substituição no nível da coluna usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as instruções DDL a seguir criam uma tabela Singers que usa o grupo de localidade ssd_only. No entanto, a coluna Awards substitui esse grupo de localidade no nível da tabela e usa o grupo de localidade spill_to_hdd como a política de armazenamento em camadas:

    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. Clique em Executar.

gcloud

Para definir uma política de armazenamento em camadas de substituição no nível da coluna com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as instruções DDL a seguir criam uma tabela Singers que usa o grupo de localidade ssd_only. No entanto, a coluna Awards substitui essa política de armazenamento em camadas no nível da tabela e usa o grupo de localidade spill_to_hdd como a política de armazenamento em camadas:

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

Definir uma política de armazenamento em camadas de substituição no nível do índice secundário

É possível definir uma política de armazenamento em níveis de substituição no nível do índice secundário para seus dados.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL CREATE INDEX com uma política de armazenamento em camadas de substituição no nível do índice secundário usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as instruções DDL a seguir criam uma tabela Singers que usa o grupo de localidade ssd_only. O banco de dados também tem um índice secundário em todos os Singers no banco de dados pelo nome e sobrenome. O índice SingersByFirstLastName substitui a política de armazenamento em camadas no nível da tabela e usa o grupo de localidade spill_to_hdd como a política de armazenamento em camadas:

    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. Clique em Executar.

gcloud

Para definir uma política de armazenamento em camadas de substituição no nível do índice secundário com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as instruções DDL a seguir criam uma tabela Singers que usa o grupo de localidade ssd_only. O banco de dados também cria um índice secundário em todos os Singers no banco de dados pelo nome e sobrenome. O índice SingersByFirstLastName substitui a política de armazenamento em camadas no nível da tabela e usa o grupo de localidade spill_to_hdd como a política de armazenamento em camadas:

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

Definir um grupo de localidades no nível da coluna

É possível definir um grupo de localidade no nível da coluna para seus dados, mesmo que o grupo de localidade não tenha uma política de armazenamento em camadas. A leitura de dados dessa coluna é mais rápida do que a leitura de dados agrupados com outras colunas.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL CREATE TABLE que atribui a coluna a um grupo de localidade usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as instruções DDL a seguir criam uma tabela Songs com uma coluna LyricsCompressed armazenada separadamente no grupo de localidades 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. Clique em Executar.

gcloud

Para definir um grupo de localidade de coluna para seus dados com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as instruções DDL a seguir criam uma tabela Songs com uma coluna LyricsCompressed armazenada separadamente no grupo de localidades 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;

Mover dados entre opções de armazenamento

É possível mover dados entre o armazenamento SSD e HDD. A transferência de dados pode levar até sete dias. É possível monitorar o progresso da migração consultando a tabela SPANNER_SYS.TABLE_SIZES_STATS_1HOUR integrada para verificar o uso de armazenamento de HDD e SSD em cada tabela no seu banco de dados. Também é possível monitorar o uso de armazenamento usando a métrica spanner.googleapis.com/instance/storage/used_bytes do Cloud Monitoring para mostrar o detalhamento de SSD e HDD do seu banco de dados ou instância. Para mais informações, consulte Observabilidade do armazenamento em camadas.

Mover dados do armazenamento SSD para o HDD

Para mover dados do armazenamento SSD para o HDD, crie um novo grupo de localidades com uma política de armazenamento em camadas com base na idade ou mude a política de armazenamento em camadas de um grupo de localidades. A transferência de dados de SSD para HDD pode levar até sete dias. Para mais informações, consulte Criar uma política baseada na idade para o grupo de localidade ou Mudar a opção de armazenamento.

Mover dados do armazenamento HDD para o SSD

Para mover dados do armazenamento HDD para o SSD, mude a opção de armazenamento de um grupo de localidades ou altere o grupo de localidades usado pela tabela. A transferência de dados de SSD para HDD pode levar até sete dias.

Alterar o grupo de localidades usado por uma tabela

É possível alterar o grupo de localidade usado por uma tabela definindo um novo ou diferente grupo de localidade nas opções da tabela.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL ALTER TABLE que muda o grupo de localidade usado pela tabela usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as instruções DDL a seguir alteram o grupo de localidade usado pela tabela, Singers, para 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. Clique em Executar.

gcloud

Para alterar o grupo de localidade usado por uma tabela com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as instruções DDL a seguir alteram o grupo de localidade usado pela tabela, Singers, para 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;"

Alterar o grupo de localidade usado pela coluna de uma tabela

É possível alterar o grupo de localidade usado pela coluna de uma tabela definindo o grupo de localidade nas opções da coluna.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL ALTER TABLE que muda o grupo de localidade usado pela tabela usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as instruções DDL a seguir alteram o grupo de localidade usado pela coluna da tabela, LastName, para 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. Clique em Executar.

gcloud

Para alterar o grupo de localidade usado por uma tabela com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as instruções DDL a seguir alteram o grupo de localidade usado pela coluna da tabela, LastName, para 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;"

Alterar um grupo de localidades

É possível alterar um grupo de localidades mudando a opção de armazenamento ou mudando a política com base na idade.

Mudar a opção de armazenamento

É possível mudar a opção de armazenamento de um grupo de localidades de SSD para HDD ou de HDD para SSD.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL ALTER LOCALITY GROUP usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as instruções DDL a seguir mudam a opção de armazenamento do grupo de localidade, separate_storage, para HDD:

    GoogleSQL 

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

    PostgreSQL 

    ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';

  3. Clique em Executar.

gcloud

Para mudar a opção de armazenamento de um grupo de localidades com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as instruções DDL a seguir mudam a opção de armazenamento do grupo de localidade, separate_storage, para 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';"

Mudar a política com base na idade

É possível mudar a política baseada na idade de um grupo de localidades estendendo ou encurtando o tempo em que os dados ficam armazenados no SSD antes de serem movidos para o armazenamento de HDD.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL ALTER LOCALITY GROUP usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, as seguintes instruções DDL mudam a política baseada na idade do grupo de localidade, spill_to_hdd, estendendo o tempo em que os dados são armazenados em SSD para 20 dias:

    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. Clique em Executar.

gcloud

Para mudar a política baseada na idade de um grupo de localidades com o comando da CLI gcloud, use gcloud spanner databases ddl update.

Por exemplo, as seguintes instruções DDL mudam a política baseada na idade do grupo de localidade, spill_to_hdd, estendendo o tempo em que os dados são armazenados em SSD para 20 dias:

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

Excluir um grupo de localidades

Não é possível excluir um grupo de localidades se ele tiver dados. Primeiro, você precisa mover todos os dados que estão no grupo de localidade para outro grupo de localidade. Para mais informações, consulte Alterar o grupo de localidades usado pela tabela.

Console

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  2. Insira a instrução DDL DROP LOCALITY GROUP usando o GoogleSQL ou o PostgreSQL.

    Por exemplo, execute o seguinte para excluir um grupo de localidade ssd_only:

    GoogleSQL 

    DROP LOCALITY GROUP ssd_only;

    PostgreSQL 

    DROP LOCALITY GROUP ssd_only;

  3. Clique em Executar.

gcloud

Para excluir um grupo de localidades com o comando da gcloud CLI, use gcloud spanner databases ddl update.

Por exemplo, para descartar o grupo de localidades ssd_only, execute:

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"

A seguir