Créer et gérer des groupes de localités

Cette page explique comment créer et gérer des groupes de localités Spanner. Vous pouvez utiliser des groupes de localités pour définir la stratégie de stockage en niveaux pour les données de votre schéma de base de données. Pour en savoir plus sur le fonctionnement du stockage en niveaux, consultez la section Stockage en niveaux.

Créer un groupe de localités

Vous pouvez créer un groupe de localités sans stratégie de stockage en plusieurs niveaux, ou vous pouvez créer un groupe de localités pour définir la stratégie de stockage des données dans le schéma de votre base de données.

Console

  1. Accédez à la page Instances de Spanner dans la console Google Cloud.

    Instances

  2. Sélectionnez l'instance dans laquelle vous souhaitez utiliser le stockage en niveaux.

  3. Sélectionnez la base de données dans laquelle vous souhaitez utiliser le stockage en niveaux.

  4. Dans le menu de navigation, cliquez sur Spanner Studio.

  5. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.

  6. Saisissez l'instruction DDL CREATE LOCALITY GROUP à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, vous pouvez exécuter la commande suivante pour créer un groupe de localités, separate_storage, qui stocke les colonnes dans un fichier distinct des données pour le reste des colonnes:

    GoogleSQL

    CREATE LOCALITY GROUP separate_storage;
    

    PostgreSQL

    CREATE LOCALITY GROUP separate_storage;
    

    Par exemple, vous pouvez exécuter la commande suivante pour créer un groupe de localité, ssd_only, qui stocke des données sur un stockage SSD:

    GoogleSQL

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

    PostgreSQL

    CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';
    

    Par exemple, vous pouvez exécuter la commande suivante pour créer un groupe de localité, hdd_only, qui stocke des données sur un disque dur:

    GoogleSQL

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

    PostgreSQL

    CREATE LOCALITY GROUP hdd_only STORAGE 'hdd';
    
  7. Cliquez sur Exécuter.

gcloud

Pour créer un groupe de localités avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, vous pouvez exécuter la commande suivante pour créer un groupe de localités, separate_storage, qui stocke les colonnes dans un fichier distinct des données pour le reste des colonnes:

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"

Par exemple, vous pouvez exécuter la commande suivante pour créer un groupe de localité, ssd_only, qui stocke des données sur un 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'"

Par exemple, vous pouvez exécuter la commande suivante pour créer un groupe de localité, hdd_only, qui stocke des données sur un disque dur:

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

Créer une règle basée sur l'âge pour un groupe de localités

Un groupe de localités avec une règle basée sur l'âge stocke les données les plus récentes dans un stockage SSD pendant une durée spécifiée. Une fois le délai spécifié écoulé, Spanner migre les données vers le stockage sur disque dur lors de son cycle de compactage normal, qui se produit généralement dans les sept jours suivant l'heure spécifiée. Lorsque vous utilisez une stratégie de stockage en niveaux basée sur l'âge, la durée minimale pendant laquelle les données doivent être stockées sur un SSD avant d'être transférées sur un disque dur est d'une heure.

Pour créer un groupe de localités basé sur l'âge, utilisez l'instruction LDD CREATE LOCALITY GROUP.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL CREATE LOCALITY GROUP à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, l'instruction DDL suivante crée un groupe de localité, spill_to_hdd, qui stocke les données sur un stockage SSD pendant les 10 premiers jours, puis migre les données plus anciennes vers un stockage HDD au cours du cycle de compaction 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. Cliquez sur Exécuter.

gcloud

Pour créer un groupe de localités basé sur l'âge avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, l'instruction DDL suivante crée un groupe de localité spill_to_hdd qui stocke les données sur SSD pendant les 10 premiers jours, puis migre les données plus anciennes vers le disque dur au cours du cycle de compaction 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'"

Définir une stratégie de stockage en niveaux pour vos données

Une fois que vous avez créé votre groupe de localités, vous pouvez définir la stratégie de stockage en niveaux pour vos données. La stratégie de stockage en niveaux détermine le groupe de localité utilisé par les données. Vous pouvez définir la stratégie de stockage en niveaux au niveau de la base de données, de la table, de la colonne ou de l'index secondaire. Chaque objet de base de données hérite de sa stratégie de stockage en niveaux de son parent, sauf si elle est explicitement remplacée.

Définir un groupe de localités au niveau de la base de données

Par défaut, toutes les données sont stockées sur un SSD. Vous pouvez modifier la stratégie de stockage à plusieurs niveaux au niveau de la base de données en modifiant le groupe de localités default. Pour les bases de données en dialecte GoogleSQL, votre instruction DDL ALTER LOCALITY GROUP doit contenir default entre guillemets (`default`). Vous n'avez besoin d'inclure les guillemets que pour le groupe de localités default.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL ALTER LOCALITY GROUP à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, les instructions DDL suivantes modifient le groupe de localité default pour utiliser une stratégie de stockage en niveaux basée sur l'âge. Toutes les données de la base de données sont déplacées vers le stockage sur disque dur au bout de 10 jours.

    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. Cliquez sur Exécuter.

gcloud

Pour modifier la stratégie de stockage en niveaux du groupe de localité default avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions DDL suivantes modifient le groupe de localité default pour utiliser une stratégie de stockage en niveaux basée sur l'âge. Toutes les données de la base de données sont déplacées vers le stockage sur disque dur au bout de 10 jours.

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

Définir un groupe de localités au niveau de la table

Vous pouvez définir une stratégie de stockage à plusieurs niveaux au niveau de la table pour vos données, qui remplace la stratégie de stockage à plusieurs niveaux au niveau de la base de données.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL CREATE TABLE à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, les instructions DDL suivantes créent une table, Singers, qui utilise le groupe de localités 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. Cliquez sur Exécuter.

gcloud

Pour définir une stratégie de stockage à plusieurs niveaux au niveau de la table avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions DDL suivantes créent une table, Singers, qui utilise le groupe de localités 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;"

Définir une stratégie de stockage à plusieurs niveaux au niveau des colonnes

Vous pouvez définir une règle de stockage à plusieurs niveaux de remplacement au niveau des colonnes pour vos données.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL CREATE TABLE avec une stratégie de stockage à plusieurs niveaux de remplacement au niveau de la colonne à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, les instructions LDD suivantes créent une table Singers qui utilise le groupe de localités ssd_only. Toutefois, la colonne Awards remplace ce groupe de localité au niveau de la table et utilise le groupe de localité spill_to_hdd comme stratégie de stockage à plusieurs niveaux:

    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. Cliquez sur Exécuter.

gcloud

Pour définir une stratégie de stockage à niveaux de remplacement au niveau des colonnes avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions LDD suivantes créent une table Singers qui utilise le groupe de localités ssd_only. Toutefois, la colonne Awards remplace cette stratégie de stockage à plusieurs niveaux au niveau de la table et utilise le groupe de localité spill_to_hdd comme stratégie de stockage à plusieurs niveaux:

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

Définir une règle de stockage à plusieurs niveaux de remplacement au niveau de l'index secondaire

Vous pouvez définir une stratégie de stockage à plusieurs niveaux de remplacement au niveau de l'index secondaire pour vos données.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL CREATE INDEX avec une stratégie de stockage à plusieurs niveaux de remplacement au niveau de l'index secondaire à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, les instructions LDD suivantes créent une table Singers qui utilise le groupe de localités ssd_only. La base de données comporte également un indice secondaire sur tous les Singers de la base de données par leur prénom et leur nom. L'index SingersByFirstLastName remplace la stratégie de stockage à plusieurs niveaux au niveau de la table et utilise le groupe de localité spill_to_hdd comme stratégie de stockage à plusieurs niveaux:

    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. Cliquez sur Exécuter.

gcloud

Pour définir une stratégie de stockage à plusieurs niveaux de remplacement au niveau de l'index secondaire avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions LDD suivantes créent une table Singers qui utilise le groupe de localités ssd_only. La base de données crée également un indice secondaire sur tous les Singers de la base de données par leur prénom et leur nom. L'index SingersByFirstLastName remplace la stratégie de stockage à plusieurs niveaux au niveau de la table et utilise le groupe de localité spill_to_hdd comme stratégie de stockage à plusieurs niveaux:

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

Définir un groupe de localités au niveau des colonnes

Vous pouvez définir un groupe de localité au niveau des colonnes pour vos données, même si le groupe de localité ne dispose pas d'une stratégie de stockage à plusieurs niveaux. La lecture des données de cette colonne est plus rapide que celle des données regroupées avec d'autres colonnes.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL CREATE TABLE qui attribue la colonne à un groupe de localités à l'aide de GoogleSQL ou de PostgreSQL.

    Par exemple, les instructions LDD suivantes créent une table Songs avec une colonne LyricsCompressed stockée séparément dans le groupe de localité 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. Cliquez sur Exécuter.

gcloud

Pour définir un groupe de localité au niveau des colonnes pour vos données avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions LDD suivantes créent une table Songs avec une colonne LyricsCompressed stockée séparément dans le groupe de localité 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;

Déplacer des données entre des options de stockage

Vous pouvez déplacer des données entre le stockage SSD et HDD. Le transfert de données peut prendre jusqu'à sept jours. Vous pouvez suivre la progression du transfert en interrogeant la table SPANNER_SYS.TABLE_SIZES_STATS_1HOUR intégrée pour vérifier l'utilisation du stockage HDD et SSD pour chaque table de votre base de données. Vous pouvez également surveiller votre utilisation de l'espace de stockage à l'aide de la métrique spanner.googleapis.com/instance/storage/used_bytes de Cloud Monitoring pour afficher la répartition entre SSD et HDD pour votre base de données ou votre instance. Pour en savoir plus, consultez la section Observabilité du stockage à niveaux.

Déplacer des données d'un SSD vers un stockage HDD

Pour déplacer des données d'un SSD vers un stockage HDD, vous pouvez créer un groupe de localités avec une règle de stockage en niveaux basée sur l'ancienneté ou modifier la règle de stockage en niveaux d'un groupe de localités existant. Le transfert de données d'un SSD vers un disque dur peut prendre jusqu'à sept jours. Pour en savoir plus, consultez Créer une règle basée sur l'âge pour le groupe de localités ou Modifier l'option de stockage.

Déplacer des données d'un disque dur vers un stockage SSD

Pour déplacer des données d'un disque dur vers un stockage SSD, vous pouvez modifier l'option de stockage d'un groupe de localités existant ou modifier le groupe de localités utilisé par le tableau. Le transfert de données d'un SSD vers un disque dur peut prendre jusqu'à sept jours.

Modifier le groupe de localités utilisé par une table

Vous pouvez modifier le groupe de localités utilisé par une table en définissant un nouveau groupe de localités ou un groupe de localités différent dans les options de la table.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL ALTER TABLE qui modifie le groupe de localité utilisé par la table à l'aide de GoogleSQL ou de PostgreSQL.

    Par exemple, les instructions DDL suivantes remplacent le groupe de localité utilisé par la table, Singers, par 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. Cliquez sur Exécuter.

gcloud

Pour modifier le groupe de localité utilisé par une table avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions DDL suivantes remplacent le groupe de localité utilisé par la table, Singers, par 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;"

Modifier le groupe de localité utilisé par la colonne d'une table

Vous pouvez modifier le groupe de localités utilisé par la colonne d'une table en définissant le groupe de localités dans les options de la colonne.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL ALTER TABLE qui modifie le groupe de localité utilisé par la table à l'aide de GoogleSQL ou de PostgreSQL.

    Par exemple, les instructions LDD suivantes remplacent le groupe de localité utilisé par la colonne de la table, LastName, par 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. Cliquez sur Exécuter.

gcloud

Pour modifier le groupe de localité utilisé par une table avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions LDD suivantes remplacent le groupe de localité utilisé par la colonne de la table, LastName, par 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;"

Modifier un groupe de localités

Vous pouvez modifier un groupe de localités en modifiant son option de stockage ou en modifiant sa stratégie basée sur l'âge.

Modifier l'option de stockage

Vous pouvez modifier l'option de stockage d'un groupe de localités de SSD en HDD ou de HDD en SSD.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL ALTER LOCALITY GROUP à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, les instructions DDL suivantes remplacent l'option de stockage du groupe de localité, separate_storage, par HDD:

    GoogleSQL

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

    PostgreSQL

    ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';
    
  3. Cliquez sur Exécuter.

gcloud

Pour modifier l'option de stockage d'un groupe de localités avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions DDL suivantes remplacent l'option de stockage du groupe de localité, separate_storage, par 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';"

Modifier les règles basées sur l'âge

Vous pouvez modifier la règle basée sur l'âge d'un groupe de localités en prolongeant ou en raccourcissant la durée de stockage des données sur un SSD avant qu'elles ne soient déplacées vers un stockage sur disque dur.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL ALTER LOCALITY GROUP à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, les instructions DDL suivantes modifient la règle basée sur l'âge du groupe de localité, spill_to_hdd, en étendant la durée de stockage des données sur le SSD à 20 jours:

    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. Cliquez sur Exécuter.

gcloud

Pour modifier la stratégie basée sur l'âge d'un groupe de localités à l'aide de la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, les instructions DDL suivantes modifient la règle basée sur l'âge du groupe de localité, spill_to_hdd, en étendant la durée de stockage des données sur le SSD à 20 jours:

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

Supprimer un groupe de localités

Vous ne pouvez pas supprimer un groupe de localités s'il contient des données. Vous devez d'abord déplacer toutes les données du groupe de localités vers un autre groupe de localités. Pour en savoir plus, consultez Modifier le groupe de localité utilisé par la table.

Console

  1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
  2. Saisissez l'instruction DDL DROP LOCALITY GROUP à l'aide de Google SQL ou de PostgreSQL.

    Par exemple, vous pouvez exécuter la commande suivante pour supprimer un groupe de localités ssd_only:

    GoogleSQL

    DROP LOCALITY GROUP ssd_only;
    

    PostgreSQL

    DROP LOCALITY GROUP ssd_only;
    
  3. Cliquez sur Exécuter.

gcloud

Pour supprimer un groupe de localités avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.

Par exemple, pour supprimer le groupe de localités ssd_only, exécutez la commande suivante:

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"

Étape suivante