Ortsgruppen erstellen und verwalten

Hinweis: Diese Funktion ist in der Spanner Enterprise-Version und Enterprise Plus-Version verfügbar. Weitere Informationen finden Sie in der Übersicht über Spanner-Versionen.

Auf dieser Seite wird beschrieben, wie Sie Lokalisierungsgruppen in Spanner erstellen und verwalten. Mit Standortgruppen können Sie die Richtlinie für gestaffelten Speicher für Daten in Ihrem Datenbankschema definieren. Informationen zur Funktionsweise von gestuftem Speicher finden Sie unter Gestufter Speicher.

Standortgruppe erstellen

Sie können eine Standortgruppe ohne Richtlinie für gestaffelten Speicher erstellen oder eine Standortgruppe erstellen, um die Speicherrichtlinie für Daten in Ihrem Datenbankschema zu definieren.

Wenn Sie eine Lokalisierungsgruppe ohne Richtlinie für gestuften Speicher erstellen, übernimmt die Lokalisierungsgruppe die Richtlinie für gestuften Speicher der Lokalisierungsgruppe default. Wenn Sie die Speicherrichtlinie der Lokalisierungsgruppe default nicht manuell festgelegt haben, ist die Speicherrichtlinie auf „Nur SSD“ festgelegt.

Console

1. Rufen Sie in derGoogle Cloud Console die Spanner-Seite Instanzen auf.

   Instanzen

2. Wählen Sie die Instanz aus, in der Sie den mehrstufigen Speicher verwenden möchten.

3. Wählen Sie die Datenbank aus, in der Sie den gestuften Speicher verwenden möchten.

4. Klicken Sie im Navigationsmenü auf Spanner Studio.

5. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

6. Geben Sie die CREATE LOCALITY GROUP-DDL-Anweisung mit GoogleSQL oder PostgreSQL ein.

   Sie können beispielsweise Folgendes ausführen, um eine Lokalisierungsgruppe separate_storage zu erstellen, in der Spalten in einer separaten Datei gespeichert werden, die sich von den Daten für die restlichen Spalten unterscheidet:

   GoogleSQL

   CREATE LOCALITY GROUP separate_storage;
   

   PostgreSQL

   CREATE LOCALITY GROUP separate_storage;
   

   Sie können beispielsweise Folgendes ausführen, um eine Standortgruppe ssd_only zu erstellen, die Daten auf SSD-Speicher speichert:

   GoogleSQL

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

   PostgreSQL

   CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';
   

   Sie können beispielsweise Folgendes ausführen, um eine Lokalisierungsgruppe hdd_only zu erstellen, die Daten auf einem HDD-Speicher speichert:

   GoogleSQL

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

   PostgreSQL

   CREATE LOCALITY GROUP hdd_only STORAGE 'hdd';
   

7. Klicken Sie auf Ausführen.

gcloud

Verwenden Sie gcloud spanner databases ddl update, um eine Standortgruppe mit dem Google Cloud CLI-Befehl zu erstellen.

Sie können beispielsweise Folgendes ausführen, um eine Lokalisierungsgruppe separate_storage zu erstellen, in der Spalten in einer separaten Datei gespeichert werden, die sich von den Daten für die restlichen Spalten unterscheidet:

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"

Sie können beispielsweise den folgenden Befehl ausführen, um eine Standortgruppe ssd_only zu erstellen, die Daten auf einer SSD speichert:

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

Sie können beispielsweise Folgendes ausführen, um eine Lokalisierungsgruppe hdd_only zu erstellen, die Daten auf einem HDD-Speicher speichert:

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

Altersbasierte Richtlinie für eine Standortgruppe erstellen

In einer Standortgruppe mit einer altersbasierten Richtlinie werden neuere Daten für einen bestimmten Zeitraum im SSD-Speicher gespeichert. Diese Zeit ist relativ zum Commit-Zeitstempel der Daten. Nach Ablauf der angegebenen Zeit migriert Spanner die Daten während des normalen Komprimierungszyklus in den HDD-Speicher. Dies geschieht in der Regel innerhalb von sieben Tagen nach der angegebenen Zeit. Wenn Sie eine altersbasierte Richtlinie für gestuften Speicher verwenden, müssen Daten mindestens eine Stunde lang auf SSD gespeichert werden, bevor sie in den HDD-Speicher verschoben werden.

Verwenden Sie zum Erstellen einer altersbasierten Standortgruppe die DDL-Anweisung CREATE LOCALITY GROUP.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die CREATE LOCALITY GROUP-DDL-Anweisung mit GoogleSQL oder PostgreSQL ein.

   Mit der folgenden DDL-Anweisung wird beispielsweise eine Lokalisierungsgruppe spill_to_hdd erstellt, in der Daten die ersten 10 Tage auf SSD-Speicher gespeichert werden. Ältere Daten werden dann im Rahmen des normalen Komprimierungszyklus auf HDD-Speicher migriert:

   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. Klicken Sie auf Ausführen.

gcloud

Verwenden Sie gcloud spanner databases ddl update, um eine altersbasierte Standortgruppe mit dem gcloud CLI-Befehl zu erstellen.

Mit der folgenden DDL-Anweisung wird beispielsweise eine Lokalisierungsgruppe spill_to_hdd erstellt, in der Daten für die ersten 10 Tage auf SSD gespeichert werden. Ältere Daten werden dann im Rahmen des normalen Komprimierungszyklus auf HDD migriert.

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

Richtlinie für mehrstufigen Speicher für Ihre Daten festlegen

Nachdem Sie die Standortgruppe erstellt haben, können Sie die Richtlinie für gestaffelten Speicher für Ihre Daten festlegen. Die Richtlinie für gestuften Speicher bestimmt die Standortgruppe, die die Daten verwenden. Sie können die Richtlinie für gestaffelten Speicher auf Datenbank-, Tabellen-, Spalten- oder sekundärer Indexebene festlegen. Jedes Datenbankobjekt übernimmt die Richtlinie für gestuften Speicher von seinem übergeordneten Objekt, sofern sie nicht explizit überschrieben wird.

Wenn Sie eine Lokalisierungsgruppe ohne Richtlinie für gestuften Speicher erstellen, übernimmt die Lokalisierungsgruppe die Richtlinie für gestuften Speicher der Lokalisierungsgruppe default. Wenn Sie die Speicherrichtlinie der Lokalisierungsgruppe default nicht manuell festgelegt haben, ist die Speicherrichtlinie auf „Nur SSD“ festgelegt.

Standortgruppe auf Datenbankebene festlegen

Die Standardrichtlinie für gestaffelten Speicher sieht vor, dass alle Daten auf SSD-Speicher gespeichert werden. Sie können die Richtlinie für gestaffelten Speicher auf Datenbankebene ändern, indem Sie die Lokalisierungsgruppe default ändern. Bei Datenbanken mit GoogleSQL-Dialekt muss die DDL-Anweisung ALTER LOCALITY GROUP default in Backticks (`default`) enthalten. Sie müssen die Backticks nur für die Standortgruppe default angeben.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die ALTER LOCALITY GROUP-DDL-Anweisung mit GoogleSQL oder PostgreSQL ein.

   Mit den folgenden DDL-Anweisungen wird beispielsweise die Standortgruppe default so geändert, dass eine altersbasierte Richtlinie für gestaffelten Speicher verwendet wird. Alle Daten in der Datenbank werden nach 10 Tagen in den HDD-Speicher verschoben.

   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. Klicken Sie auf Ausführen.

gcloud

Wenn Sie die Richtlinie für gestaffelten Speicher der Standortgruppe default mit dem gcloud CLI-Befehl ändern möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise die Standortgruppe default so geändert, dass eine altersbasierte Richtlinie für gestaffelten Speicher verwendet wird. Alle Daten in der Datenbank werden nach 10 Tagen in den HDD-Speicher verschoben.

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

Standortgruppe auf Tabellenebene festlegen

Sie können für Ihre Daten eine Richtlinie für mehrstufigen Speicher auf Tabellenebene festlegen, die die Richtlinie für mehrstufigen Speicher auf Datenbankebene überschreibt. Die Richtlinie für gestaffelten Speicher auf Tabellenebene gilt auch für alle Spalten in der Tabelle, es sei denn, Sie haben eine Richtlinie für gestaffelten Speicher auf Spaltenebene festgelegt.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die CREATE TABLE-DDL-Anweisung mit GoogleSQL oder PostgreSQL ein.

   Mit den folgenden DDL-Anweisungen wird beispielsweise die Tabelle Singers erstellt, die die Lokalisierungsgruppe ssd_only verwendet:

   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. Klicken Sie auf Ausführen.

gcloud

Verwenden Sie gcloud spanner databases ddl update, um eine Richtlinie für gestaffelten Speicher auf Tabellenebene mit dem gcloud CLI-Befehl festzulegen.

Mit den folgenden DDL-Anweisungen wird beispielsweise die Tabelle Singers erstellt, die die Lokalisierungsgruppe ssd_only verwendet.

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

Richtlinie für mehrstufigen Speicher auf Spaltenebene überschreiben

Sie können eine Richtlinie für mehrstufigen Speicher auf Spaltenebene für Ihre Daten festlegen.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die CREATE TABLE-DDL-Anweisung mit einer Tiered Storage-Richtlinie mit Überschreibung auf Spaltenebene ein. Verwenden Sie dazu GoogleSQL oder PostgreSQL.

   Mit den folgenden DDL-Anweisungen wird beispielsweise eine Singers-Tabelle erstellt, die die Lokalisierungsgruppe ssd_only verwendet. Die Spalte Awards überschreibt jedoch diese Standortgruppe auf Tabellenebene und verwendet die Standortgruppe spill_to_hdd als Richtlinie für den gestuften Speicher:

   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. Klicken Sie auf Ausführen.

gcloud

Wenn Sie eine Richtlinie für gestaffelten Speicher auf Spaltenebene mit dem gcloud CLI-Befehl festlegen möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise eine Singers-Tabelle erstellt, die die Lokalisierungsgruppe ssd_only verwendet. Die Spalte Awards überschreibt jedoch diese Richtlinie für gestaffelten Speicher auf Tabellenebene und verwendet die Lokalisierungsgruppe spill_to_hdd als Richtlinie für gestaffelten Speicher:

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

Richtlinie für mehrstufigen Speicher auf sekundärer Indexebene festlegen

Sie können eine sekundäre Richtlinie für gestuften Speicher auf Indexebene für Ihre Daten festlegen.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die CREATE INDEX-DDL-Anweisung mit einer Tiered Storage-Richtlinie ein, die die sekundäre Indexebene überschreibt, und verwenden Sie dazu GoogleSQL oder PostgreSQL.

   Mit den folgenden DDL-Anweisungen wird beispielsweise eine Singers-Tabelle erstellt, die die Lokalisierungsgruppe ssd_only verwendet. Die Datenbank hat auch einen sekundären Index für alle Singers in der Datenbank nach Vor- und Nachnamen. Der Index SingersByFirstLastName überschreibt die Richtlinie für gestaffelten Speicher auf Tabellenebene und verwendet die Lokalisierungsgruppe spill_to_hdd als Richtlinie für gestaffelten Speicher:

   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. Klicken Sie auf Ausführen.

gcloud

Wenn Sie mit dem gcloud CLI-Befehl eine sekundäre Richtlinie für gestaffelten Speicher auf Indexebene festlegen möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise eine Singers-Tabelle erstellt, die die Lokalisierungsgruppe ssd_only verwendet. Die Datenbank erstellt außerdem einen sekundären Index für alle Singers in der Datenbank nach Vor- und Nachnamen. Der Index SingersByFirstLastName überschreibt die Richtlinie für gestaffelten Speicher auf Tabellenebene und verwendet die Lokalisierungsgruppe spill_to_hdd als Richtlinie für gestaffelten Speicher:

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

Standortgruppe auf Spaltenebene festlegen

Sie können eine Standortgruppe auf Spaltenebene für Ihre Daten festlegen, auch wenn die Standortgruppe keine Richtlinie für gestaffelten Speicher hat. Das Lesen von Daten aus dieser Spalte ist schneller als das Lesen von Daten, die mit anderen Spalten gruppiert sind.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die CREATE TABLE-DDL-Anweisung ein, mit der die Spalte einer Standortgruppe mit GoogleSQL oder PostgreSQL zugewiesen wird.

   Mit den folgenden DDL-Anweisungen wird beispielsweise eine Songs-Tabelle mit einer LyricsCompressed-Spalte erstellt, die separat in der Lokalisierungsgruppe hdd_only gespeichert wird:

   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. Klicken Sie auf Ausführen.

gcloud

Wenn Sie mit dem gcloud CLI-Befehl eine Standortgruppe auf Spaltenebene für Ihre Daten festlegen möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise eine Songs-Tabelle mit einer LyricsCompressed-Spalte erstellt, die separat in der hdd_only-Lokalisierungsgruppe gespeichert wird:

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;

Daten zwischen Speicheroptionen verschieben

Sie können Daten zwischen SSD- und HDD-Speicher verschieben. Das Verschieben von Daten kann bis zu sieben Tage dauern. Wenn Sie Daten schneller zwischen SSD und HDD migrieren möchten, können Sie manuell eine Hauptkomprimierung auslösen. Sie können den Fortschritt der Verschiebung überwachen, indem Sie die integrierte Tabelle SPANNER_SYS.TABLE_SIZES_STATS_1HOUR abfragen, um die HDD- und SSD-Speichernutzung für jede Tabelle in Ihrer Datenbank zu prüfen. Sie können die Speichernutzung auch mit dem Cloud Monitoring-Messwert spanner.googleapis.com/instance/storage/used_bytes überwachen, um die SSD- und HDD-Aufschlüsselung für Ihre Datenbank oder Instanz anzuzeigen. Weitere Informationen finden Sie unter Beobachtbarkeit von gestuftem Speicher.

Daten von SSD- in HDD-Speicher verschieben

Wenn Sie Daten von SSD- in HDD-Speicher verschieben möchten, können Sie eine neue Standortgruppe mit einer altersbasierten Richtlinie für gestuften Speicher erstellen oder die Richtlinie für gestuften Speicher einer vorhandenen Standortgruppe ändern. Spanner verschiebt Daten während des normalen Komprimierungszyklus, der in der Regel innerhalb von sieben Tagen erfolgt. Wenn Sie Daten laden und Ihre Standortgruppe mit einer der folgenden ALTER-DDL-Anweisungen aktualisieren, müssen Sie bis zu sieben Tage warten, bis die Änderung an der Standortgruppe abgeschlossen ist:

GoogleSQL

• ALTER TABLE ... SET OPTIONS (locality_group = '')
• ALTER TABLE ... ALTER COLUMN ... SET OPTIONS (locality_group = '')
• ALTER INDEX ... SET OPTIONS (locality_group = '')

PostgreSQL

• ALTER TABLE ... SET LOCALITY GROUP ...
• ALTER TABLE ... ALTER COLUMN ... SET LOCALITY GROUP ...
• ALTER INDEX ... SET LOCALITY GROUP ...

Die Wartezeit gilt nicht, wenn Sie eine neue Tabelle, Spalte oder einen neuen Index erstellen und die Lokalisierungsgruppe als Teil der CREATE- oder ADD COLUMN-Syntax hinzufügen.

Weitere Informationen finden Sie unter Altersbasierte Richtlinie für eine Standortgruppe erstellen oder Speicheroption ändern.

Daten von HDD- in SSD-Speicher verschieben

Wenn Sie Daten von HDD- zu SSD-Speicher verschieben möchten, können Sie die Speicheroption einer vorhandenen Lokalisierungsgruppe ändern oder die von der Tabelle verwendete Lokalisierungsgruppe ändern. Cloud Spanner verschiebt Daten während des normalen Komprimierungszyklus, der in der Regel innerhalb von sieben Tagen erfolgt. Wenn Sie Daten laden und Ihre Standortgruppe mit einer der folgenden ALTER-DDL-Anweisungen aktualisieren, müssen Sie bis zu sieben Tage warten, bis die Änderung an der Standortgruppe abgeschlossen ist:

GoogleSQL

• ALTER TABLE ... SET OPTIONS (locality_group = '')
• ALTER TABLE ... ALTER COLUMN ... SET OPTIONS (locality_group = '')
• ALTER INDEX ... SET OPTIONS (locality_group = '')

PostgreSQL

• ALTER TABLE ... SET LOCALITY GROUP ...
• ALTER TABLE ... ALTER COLUMN ... SET LOCALITY GROUP ...
• ALTER INDEX ... SET LOCALITY GROUP ...

Die Wartezeit gilt nicht, wenn Sie eine neue Tabelle, Spalte oder einen neuen Index erstellen und die Standortgruppe als Teil der CREATE- oder ADD COLUMN-Syntax hinzufügen.

Von einer Tabelle verwendete Standortgruppe ändern

Sie können die von einer Tabelle verwendete Lokalisierungsgruppe ändern, indem Sie in den Tabellenoptionen eine neue oder andere Lokalisierungsgruppe festlegen.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die ALTER TABLE-DDL-Anweisung ein, die die von der Tabelle verwendete Lokalisierungsgruppe mit GoogleSQL oder PostgreSQL ändert.

   Mit den folgenden DDL-Anweisungen wird beispielsweise die von der Tabelle Singers verwendete Lokalisierungsgruppe in spill_to_hdd geändert:

   GoogleSQL

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

   PostgreSQL

   ALTER TABLE Singers SET LOCALITY GROUP spill_to_hdd;
   

3. Klicken Sie auf Ausführen.

gcloud

Wenn Sie die von einer Tabelle verwendete Lokalisierungsgruppe mit dem gcloud CLI-Befehl ändern möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise die von der Tabelle Singers verwendete Lokalisierungsgruppe in spill_to_hdd geändert:

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

Von einer Tabellenspalte verwendete Lokalisierungsgruppe ändern

Sie können die von der Spalte einer Tabelle verwendete Lokalisierungsgruppe ändern, indem Sie die Lokalisierungsgruppe in den Spaltenoptionen festlegen.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die ALTER TABLE-DDL-Anweisung ein, die die von der Tabelle verwendete Lokalisierungsgruppe mit GoogleSQL oder PostgreSQL ändert.

   Mit den folgenden DDL-Anweisungen wird beispielsweise die von der Spalte LastName der Tabelle verwendete Lokalisierungsgruppe in spill_to_hdd geändert:

   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. Klicken Sie auf Ausführen.

gcloud

Wenn Sie die von einer Tabelle verwendete Lokalisierungsgruppe mit dem gcloud CLI-Befehl ändern möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise die von der Spalte LastName der Tabelle verwendete Lokalisierungsgruppe in spill_to_hdd geändert:

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

Standortgruppe ändern

Sie können eine Lokalisierungsgruppe ändern, indem Sie die Speicheroption ändern oder die altersbasierte Richtlinie ändern. Cloud Spanner verschiebt Daten während des normalen Komprimierungszyklus, der in der Regel innerhalb von sieben Tagen erfolgt. Wenn Sie Daten laden und Ihre Standortgruppe mit ALTER LOCALITY GROUP aktualisieren, müssen Sie bis zu sieben Tage warten, bis vorhandene Daten migriert sind. Die aktualisierte Einstellung gilt sofort für alle neuen Daten, die in diese Standortgruppe geschrieben werden.

Speicheroption ändern

Sie können die Speicheroption einer Lokalisierungsgruppe von SSD zu HDD oder von HDD zu SSD ändern.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die ALTER LOCALITY GROUP-DDL-Anweisung mit GoogleSQL oder PostgreSQL ein.

   Mit den folgenden DDL-Anweisungen wird beispielsweise die Speicheroption der Lokalisierungsgruppe separate_storage in HDD geändert:

   GoogleSQL

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

   PostgreSQL

   ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';
   

3. Klicken Sie auf Ausführen.

gcloud

Wenn Sie die Speicheroption einer Standortgruppe mit dem gcloud CLI-Befehl ändern möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise die Speicheroption der Lokalisierungsgruppe separate_storage in HDD geändert:

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

Altersbasierte Richtlinie ändern

Sie können die altersbasierte Richtlinie einer Standortgruppe ändern, indem Sie die Zeit verlängern oder verkürzen, die Daten auf SSD gespeichert werden, bevor sie in den HDD-Speicher verschoben werden.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die ALTER LOCALITY GROUP-DDL-Anweisung mit GoogleSQL oder PostgreSQL ein.

   Mit den folgenden DDL-Anweisungen wird beispielsweise die altersbasierte Richtlinie der Standortgruppe spill_to_hdd geändert, indem die Zeit, die Daten auf SSD gespeichert werden, auf 20 Tage verlängert wird:

   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. Klicken Sie auf Ausführen.

gcloud

Wenn Sie die altersbasierte Richtlinie einer Standortgruppe mit dem gcloud CLI-Befehl ändern möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise die altersbasierte Richtlinie der Standortgruppe spill_to_hdd geändert, indem die Zeit, die Daten auf SSD gespeichert werden, auf 20 Tage verlängert wird:

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

Ortsgruppe löschen

Sie können eine Standortgruppe nicht löschen, wenn sie Daten enthält. Sie müssen zuerst alle Daten in der Standortgruppe in eine andere Standortgruppe verschieben. Weitere Informationen finden Sie unter Von der Tabelle verwendete Standortgruppe ändern.

Console

1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

2. Geben Sie die DROP LOCALITY GROUP-DDL-Anweisung mit GoogleSQL oder PostgreSQL ein.

   Sie können beispielsweise Folgendes ausführen, um die Standortgruppe ssd_only zu löschen:

   GoogleSQL

   DROP LOCALITY GROUP ssd_only;
   

   PostgreSQL

   DROP LOCALITY GROUP ssd_only;
   

3. Klicken Sie auf Ausführen.

gcloud

Verwenden Sie gcloud spanner databases ddl update, um eine Standortgruppe mit dem gcloud CLI-Befehl zu löschen.

Führen Sie beispielsweise den folgenden Befehl aus, um die Standortgruppe ssd_only zu löschen:

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"

Nächste Schritte

• Weitere Informationen zum mehrstufigen Speicher
• Weitere Informationen zu Standortgruppen
• Weitere Informationen zum Optimieren von Abfragen mit Zeitstempel-Prädikat-Pushdown