Ortsgruppen erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Spanner-Lokalitätsgruppen erstellen und verwalten. Mit Lokality-Gruppen können Sie die Richtlinie für die mehrstufige Speicherung von Daten in Ihrem Datenbankschema definieren. Informationen zur Funktionsweise von Tiered Storage finden Sie unter Tiered Storage.

Ortsgruppe erstellen

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

Wenn Sie eine Standortgruppe ohne Richtlinie für gestuften Speicher erstellen, erbt die Standortgruppe die Richtlinie für gestuften Speicher der Standortgruppe default. Wenn Sie die Speicherrichtlinie der default-Lokalisierungsgruppe nicht manuell festgelegt haben, wird sie auf „Nur SSD“ festgelegt.

Console

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

    Instanzen

  2. Wählen Sie die Instanz aus, in der Sie Tiered Storage verwenden möchten.

  3. Wählen Sie die Datenbank aus, in der Sie Tiered Storage 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.

    Mit dem folgenden Befehl können Sie beispielsweise eine Lokalitätsgruppe, separate_storage, erstellen, in der Spalten in einer separaten Datei als die Daten für die restlichen Spalten gespeichert werden:

    GoogleSQL 

    CREATE LOCALITY GROUP separate_storage;

    PostgreSQL 

    CREATE LOCALITY GROUP separate_storage;

    Mit dem folgenden Befehl können Sie beispielsweise eine Lokality-Gruppe (ssd_only) erstellen, in der Daten auf SSD-Speicher gespeichert werden:

    GoogleSQL 

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

    PostgreSQL 

    CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';

    Mit dem folgenden Befehl können Sie beispielsweise eine Lokalitätsgruppe (hdd_only) erstellen, in der Daten auf HDD-Speicher gespeichert werden:

    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 Lokalisierungsgruppe mit dem gcloud CLI-Befehl zu erstellen.

Mit dem folgenden Befehl können Sie beispielsweise eine Lokalitätsgruppe, separate_storage, erstellen, in der Spalten in einer separaten Datei als die Daten für die restlichen Spalten gespeichert werden:

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"

Mit dem folgenden Befehl können Sie beispielsweise eine Lokalisierungsgruppe (ssd_only) erstellen, in der Daten auf SSD gespeichert werden:

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

Mit dem folgenden Befehl können Sie beispielsweise eine Lokalitätsgruppe (hdd_only) erstellen, in der Daten auf HDD-Speicher gespeichert werden:

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 Ortsgruppe erstellen

In einer Ortsgruppe mit einer altersbasierten Richtlinie werden neuere Daten für einen bestimmten Zeitraum auf SSD-Speicher gespeichert. Nach Ablauf der angegebenen Zeit migriert Spanner die Daten während des normalen Verdichtungszyklus auf HDD-Speicher. Dieser Zyklus dauert in der Regel sieben Tage ab dem angegebenen Zeitpunkt. Wenn Sie eine altersbasierte Tiered Storage-Richtlinie verwenden, beträgt die Mindestzeit, die Daten auf einer SSD gespeichert werden müssen, bevor sie auf eine HDD verschoben werden, eine Stunde.

Verwenden Sie die DDL-Anweisung CREATE LOCALITY GROUP, um eine altersbasierte Lokalisierungsgruppe zu erstellen.

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 die Lokalitätsgruppe spill_to_hdd erstellt, in der Daten in den ersten 10 Tagen auf SSD-Speicher gespeichert und dann im normalen Verdichtungszyklus auf HDD-Speicher migriert werden:

    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 Lokalisierungsgruppe mit dem gcloud CLI-Befehl zu erstellen.

Mit der folgenden DDL-Anweisung wird beispielsweise die Lokalitätsgruppe spill_to_hdd erstellt, in der Daten in den ersten 10 Tagen auf SSD gespeichert und ältere Daten dann im normalen Verdichtungszyklus auf HDD migriert werden.

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 Lokalitätsgruppe erstellt haben, können Sie die Richtlinie für die mehrstufige Speicherung für Ihre Daten festlegen. Die Richtlinie für die Speicherung in verschiedenen Stufen bestimmt die Ortsgruppe, die für die Daten verwendet wird. Sie können die Richtlinie für die mehrstufige Speicherung auf Datenbank-, Tabellen-, Spalten- oder Sekundärindexebene festlegen. Jedes Datenbankobjekt erbt seine Richtlinie für den mehrstufigen Speicher von seinem übergeordneten Element, sofern sie nicht explizit überschrieben wird.

Wenn Sie eine Standortgruppe ohne Richtlinie für gestuften Speicher erstellen, erbt die Standortgruppe die Richtlinie für gestuften Speicher der Standortgruppe default. Wenn Sie die Speicherrichtlinie der default-Lokalisierungsgruppe nicht manuell festgelegt haben, wird sie auf „Nur SSD“ festgelegt.

Lokalitätsgruppe auf Datenbankebene festlegen

Die standardmäßige Richtlinie für mehrstufigen Speicher sieht vor, dass alle Daten auf SSD-Speicher gespeichert werden. Sie können die Tiered Storage-Richtlinie auf Datenbankebene ändern, indem Sie die default-Lokalitätsgruppe ändern. Bei Datenbanken mit GoogleSQL-Dialekt muss Ihre ALTER LOCALITY GROUP-DDL-Anweisung default in Graviszeichen (`default`) enthalten. Sie müssen die Graviszeichen nur für die default-Lokalitätsgruppe einfügen.

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 Lokalitätsgruppe default so geändert, dass eine altersbasierte mehrstufige Speicherrichtlinie verwendet wird. Alle Daten in der Datenbank werden nach 10 Tagen auf die Festplatte 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

Um die Richtlinie für gestuften Speicher der Lokalisierungsgruppe default mit dem gcloud CLI-Befehl zu ändern, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise die Lokalitätsgruppe default so geändert, dass eine altersbasierte mehrstufige Speicherrichtlinie verwendet wird. Alle Daten in der Datenbank werden nach 10 Tagen auf die Festplatte 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';"

Lokalitätsgruppe auf Tabellenebene festlegen

Sie können eine mehrstufige Speicherrichtlinie auf Tabellenebene für Ihre Daten festlegen, die die mehrstufige Speicherrichtlinie auf Datenbankebene überschreibt. Die Tiered Storage-Richtlinie auf Tabellenebene gilt auch für alle Spalten in der Tabelle, sofern Sie keine Tiered Storage-Richtlinie auf Spaltenebene festgelegt haben.

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 eine Tabelle, Singers, erstellt, in der die Lokality-Gruppe ssd_only verwendet wird:

    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 Tiered Storage-Richtlinie auf Tabellenebene mit dem gcloud CLI-Befehl festzulegen.

Mit den folgenden DDL-Anweisungen wird beispielsweise eine Tabelle, Singers, erstellt, in der die Lokalitätsgruppe ssd_only verwendet wird.

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

Tiered Storage-Richtlinie auf Spaltenebene überschreiben

Sie können eine mehrstufige Speicherrichtlinie 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 auf Spaltenebene ein, die GoogleSQL oder PostgreSQL verwendet.

    Mit den folgenden DDL-Anweisungen wird beispielsweise eine Tabelle Singers erstellt, die die Lokalitätsgruppe ssd_only verwendet. Die Spalte Awards überschreibt jedoch diese Lokalitätsgruppe auf Tabellenebene und verwendet die Lokalitätsgruppe spill_to_hdd als Richtlinie für den mehrstufigen 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

Verwenden Sie gcloud spanner databases ddl update, um mit dem gcloud CLI-Befehl eine Tiered Storage-Richtlinie auf Spaltenebene festzulegen.

Mit den folgenden DDL-Anweisungen wird beispielsweise eine Tabelle Singers erstellt, die die Lokalitätsgruppe ssd_only verwendet. Die Spalte Awards überschreibt jedoch diese Tiered Storage-Richtlinie auf Tabellenebene und verwendet die spill_to_hdd-Lokalisierungsgruppe als Tiered Storage-Richtlinie:

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

Tiered Storage-Richtlinie auf sekundärer Indexebene festlegen

Sie können eine sekundäre Tiered Storage-Richtlinie 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 sekundären Indexebenen-Überschreibung für die Tiered Storage-Richtlinie ein. Verwenden Sie dazu GoogleSQL oder PostgreSQL.

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

    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

Verwenden Sie gcloud spanner databases ddl update, um mit dem gcloud CLI-Befehl eine Tiered Storage-Richtlinie auf sekundärer Indexebene festzulegen.

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

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

Lokalitätsgruppe auf Spaltenebene festlegen

Sie können eine Lokalitätsgruppe auf Spaltenebene für Ihre Daten festlegen, auch wenn die Lokalitätsgruppe keine Richtlinie für mehrstufigen 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 Lokalisierungsgruppe zugewiesen wird. Verwenden Sie dazu GoogleSQL oder PostgreSQL.

    Mit den folgenden DDL-Anweisungen wird beispielsweise eine Tabelle Songs mit einer Spalte LyricsCompressed 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 Lokalitätsgruppe auf Spaltenebene für Ihre Daten festlegen möchten, verwenden Sie gcloud spanner databases ddl update.

Mit den folgenden DDL-Anweisungen wird beispielsweise eine Tabelle Songs mit einer Spalte LyricsCompressed erstellt, die separat in der Lokalisierungsgruppe hdd_only 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 Übertragen von Daten kann bis zu sieben Tage dauern. Sie können den Fortschritt der Migration ü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 Ihre Speichernutzung auch mit dem Cloud Monitoring-Messwert spanner.googleapis.com/instance/storage/used_bytes überwachen, um die Aufschlüsselung von SSD und HDD für Ihre Datenbank oder Instanz anzuzeigen. Weitere Informationen finden Sie unter Beobachtbarkeit von mehrstufigem Speicher.

Daten von SSD- in HDD-Speicher verschieben

Wenn Sie Daten von SSD- in HDD-Speicher verschieben möchten, können Sie eine neue Lokalisierungsgruppe mit einer altersbasierten Tiered Storage-Richtlinie erstellen oder die Tiered Storage-Richtlinie einer vorhandenen Lokalisierungsgruppe ändern. Spanner verschiebt Daten während des normalen Verdichtungszyklus, der in der Regel sieben Tage dauert. Wenn Sie Daten laden und Ihre Ortsgruppe mit einer der folgenden ALTER-DDL-Anweisungen aktualisieren, kann es bis zu sieben Tage dauern, bis die Änderung der Ortsgruppe 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 Ortsgruppe erstellen oder Speicheroption ändern.

Daten von HDD- in SSD-Speicher verschieben

Wenn Sie Daten von HDD- in SSD-Speicher verschieben möchten, können Sie die Speicheroption einer vorhandenen Lokalisierungsgruppe ändern oder die von der Tabelle verwendete Lokalisierungsgruppe ändern. Spanner verschiebt Daten während des normalen Verdichtungszyklus, der in der Regel sieben Tage dauert. Wenn Sie Daten laden und Ihre Standortgruppe mit einer der folgenden ALTER-DDL-Anweisungen aktualisieren, kann es bis zu sieben Tage dauern, bis die Änderung 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.

Lokalitätsgruppe einer Tabelle ändern

Sie können die von einer Tabelle verwendete Lokalitätsgruppe ändern, indem Sie in den Tabellenoptionen eine neue oder andere Lokalitätsgruppe 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, mit der die von der Tabelle verwendete Lokalisierungsgruppe mit GoogleSQL oder PostgreSQL geändert wird.

    Mit den folgenden DDL-Anweisungen wird beispielsweise die von der Tabelle Singers verwendete Lokalitätsgruppe 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

Verwenden Sie gcloud spanner databases ddl update, um die von einer Tabelle verwendete Lokalitätsgruppe mit dem gcloud CLI-Befehl zu ändern.

Mit den folgenden DDL-Anweisungen wird beispielsweise die von der Tabelle Singers verwendete Lokalitätsgruppe 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;"

Die von der Spalte einer Tabelle verwendete Lokalisierungsgruppe ändern

Sie können die von einer Tabellenspalte verwendete Lokalitätsgruppe ändern, indem Sie die Lokalitätsgruppe 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, mit der die von der Tabelle verwendete Lokalisierungsgruppe mit GoogleSQL oder PostgreSQL geändert wird.

    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

Verwenden Sie gcloud spanner databases ddl update, um die von einer Tabelle verwendete Lokalitätsgruppe mit dem gcloud CLI-Befehl zu ändern.

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

Ortsgruppe ändern

Sie können eine Ortsgruppe ändern, indem Sie ihre Speicheroption oder ihre altersbasierte Richtlinie ändern. Spanner verschiebt Daten während des normalen Verdichtungszyklus, der in der Regel sieben Tage dauert. Wenn Sie Daten laden und Ihre Standortgruppe mit ALTER LOCALITY GROUP aktualisieren, kann es bis zu sieben Tage dauern, bis vorhandene Daten migriert werden. Die aktualisierte Einstellung wird sofort auf alle neuen Daten angewendet, die in diese Standortgruppe geschrieben werden.

Speicheroption ändern

Sie können die Speicheroption einer Ortsgruppe 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 Lokality-Gruppe 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 Ortsgruppe ändern, indem Sie die Zeit verlängern oder verkürzen, in der Daten auf einer SSD gespeichert werden, bevor sie auf eine HDD 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 Ortsgruppe spill_to_hdd geändert, indem die Zeit, die Daten auf der 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

Verwenden Sie gcloud spanner databases ddl update, um die altersbasierte Richtlinie einer Ortsgruppe mit dem gcloud CLI-Befehl zu ändern.

Mit den folgenden DDL-Anweisungen wird beispielsweise die altersbasierte Richtlinie der Ortsgruppe spill_to_hdd geändert, indem die Zeit, die Daten auf der 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 Lokalitätsgruppe nicht löschen, wenn sie Daten enthält. Sie müssen zuerst alle Daten, die sich in der Standortgruppe befinden, in eine andere Standortgruppe verschieben. Weitere Informationen finden Sie unter Von der Tabelle verwendete Lokalisierungsgruppe ä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 den folgenden Befehl ausführen, um eine Ortsgruppe 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.

Wenn Sie beispielsweise die Lokalitätsgruppe ssd_only löschen möchten, führen Sie Folgendes aus:

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