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
Accédez à la page Instances de Spanner dans la console Google Cloud.
Sélectionnez l'instance dans laquelle vous souhaitez utiliser le stockage en niveaux.
Sélectionnez la base de données dans laquelle vous souhaitez utiliser le stockage en niveaux.
Dans le menu de navigation, cliquez sur Spanner Studio.
Sur la page Spanner Studio, cliquez sur
Nouvel onglet ou utilisez l'onglet de l'éditeur vide.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';
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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';
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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';
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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ésssd_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;
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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ésssd_only
. Toutefois, la colonneAwards
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;
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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ésssd_only
. La base de données comporte également un indice secondaire sur tous lesSingers
de la base de données par leur prénom et leur nom. L'indexSingersByFirstLastName
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;
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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 colonneLyricsCompressed
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;
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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
, parspill_to_hdd
:GoogleSQL
ALTER TABLE Singers SET OPTIONS (locality_group = 'spill_to_hdd');
PostgreSQL
ALTER TABLE Singers SET LOCALITY GROUP spill_to_hdd;
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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
, parspill_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;
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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';
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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';
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
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
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;
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
- En savoir plus sur le stockage par niveau
- En savoir plus sur les groupes de localités
- Découvrez comment optimiser les requêtes avec le pushdown de prédicat de code temporel.