Ortsgruppen erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Speicherortgruppen in Cloud Spanner erstellen und verwalten. Mit Ortsgruppen können Sie die Richtlinie für die abgestufte Speicherung von Daten in Ihrem Datenbankschema definieren. Informationen zur Funktionsweise von abgestuftem Speicher finden Sie unter Abgestufter Speicher.

Ortsgruppe erstellen

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

Console

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

    Instanzen

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

  3. Wählen Sie die Datenbank aus, in der Sie den abgestuften 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 DDL-Anweisung CREATE LOCALITY GROUP mit GoogleSQL oder PostgreSQL ein.

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

    GoogleSQL

    CREATE LOCALITY GROUP separate_storage;
    

    PostgreSQL

    CREATE LOCALITY GROUP separate_storage;
    

    Mit dem folgenden Befehl können Sie beispielsweise eine Lokalitätsgruppe namens ssd_only erstellen, in der Daten auf einem SSD-Speicher gespeichert werden:

    GoogleSQL

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

    PostgreSQL

    CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';
    

    So erstellen Sie beispielsweise eine Lokalitätsgruppe namens hdd_only, in der Daten auf einem 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 Standortgruppe mit der gcloud CLI zu erstellen.

So können Sie beispielsweise die folgende Anweisung ausführen, um eine Ortsgruppe namens separate_storage zu 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 Lokalitätsgruppe namens ssd_only erstellen, die Daten auf dem 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'"

So erstellen Sie beispielsweise eine Lokalitätsgruppe namens hdd_only, in der Daten auf einem 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 Standortgruppe erstellen

Bei einer Standortgruppe mit einer altersbasierten Richtlinie werden neuere Daten für einen bestimmten Zeitraum im SSD-Speicher gespeichert. Nach Ablauf der angegebenen Zeit migriert Spanner die Daten während des normalen Verdichtungszyklus auf den HDD-Speicher. Dieser Zyklus dauert in der Regel sieben Tage. Bei einer altersbasierten Speicherabstufungsrichtlinie müssen Daten mindestens eine Stunde lang im SSD gespeichert werden, bevor sie auf den HDD-Speicher verschoben werden.

Verwenden Sie die DDL-Anweisung CREATE LOCALITY GROUP, um eine altersbasierte Standortgruppe 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 DDL-Anweisung CREATE LOCALITY GROUP mit GoogleSQL oder PostgreSQL ein.

    Mit der folgenden DDL-Anweisung wird beispielsweise eine Lokalitätsgruppe namens spill_to_hdd erstellt, in der Daten die ersten 10 Tage lang im SSD-Speicher gespeichert und dann über den normalen Komprimierungszyklus auf den 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 Standortgruppe mit der gcloud CLI zu erstellen.

Mit der folgenden DDL-Anweisung wird beispielsweise eine Lokalitätsgruppe spill_to_hdd erstellt, die Daten in den ersten 10 Tagen auf dem SSD speichert und dann ältere Daten über den normalen Komprimierungszyklus auf die Festplatte 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'"

Speicherrichtlinie mit mehreren Speicherebenen für Ihre Daten festlegen

Nachdem Sie die Standortgruppe erstellt haben, können Sie die abgestufte Speicherrichtlinie für Ihre Daten festlegen. Die Richtlinie für die abgestufte Speicherung bestimmt die Standortgruppe, die für die Daten verwendet wird. Sie können die Richtlinie für die abgestufte Speicherung auf Datenbank-, Tabellen-, Spalten- oder sekundären Indexebene festlegen. Jedes Datenbankobjekt übernimmt die abgestufte Speicherrichtlinie von seinem übergeordneten Element, sofern sie nicht explizit überschrieben wird.

Ortsgruppe auf Datenbankebene festlegen

Bei der standardmäßigen Speicherabstufungsrichtlinie werden alle Daten auf SSD-Speicher gespeichert. Sie können die abgestufte Speicherrichtlinie auf Datenbankebene ändern, indem Sie die default-Lokalitätsgruppe ändern. Bei Datenbanken mit GoogleSQL-Dialekt muss die ALTER LOCALITY GROUP-DDL-Anweisung default in Backticks (`default`) enthalten. Die Backticks müssen nur für die default-Standortgruppe verwendet werden.

Console

  1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  2. Geben Sie die DDL-Anweisung ALTER LOCALITY GROUP mit GoogleSQL oder PostgreSQL ein.

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

Verwenden Sie gcloud spanner databases ddl update, um die abgestufte Speicherrichtlinie der Lokalitätsgruppe default mit dem Befehl der gcloud CLI zu ändern.

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

Ortsgruppe auf Tabellenebene festlegen

Sie können eine abgestufte Speicherrichtlinie auf Tabellenebene für Ihre Daten festlegen, die die abgestufte Speicherrichtlinie auf Datenbankebene überschreibt.

Console

  1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  2. Geben Sie die DDL-Anweisung CREATE TABLE mit GoogleSQL oder PostgreSQL ein.

    Mit den folgenden DDL-Anweisungen wird beispielsweise die Tabelle Singers erstellt, die die Ortsgruppe 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 abgestufte Speicherrichtlinie auf Tabellenebene mit der gcloud CLI festzulegen.

Mit den folgenden DDL-Anweisungen wird beispielsweise die Tabelle Singers erstellt, für die die Ortsgruppe 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;"

Überschreibung der abgestuften Speicherrichtlinie auf Spaltenebene festlegen

Sie können für Ihre Daten eine übergeordnete Speicherrichtlinie für die Speicherebene auf Spaltenebene 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 übergeordneten Speicherrichtlinie auf Spaltenebene mit GoogleSQL oder PostgreSQL ein.

    Mit den folgenden DDL-Anweisungen wird beispielsweise eine Singers-Tabelle erstellt, für die die Ortsgruppe ssd_only verwendet wird. Die Spalte Awards überschreibt jedoch diese Lokalitätsgruppe auf Tabellenebene und verwendet die Lokalitätsgruppe spill_to_hdd als abgestufte Speicherrichtlinie:

    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 eine übergeordnete Richtlinie für die Speicherebene auf Spaltenebene mit der gcloud CLI festzulegen.

Mit den folgenden DDL-Anweisungen wird beispielsweise eine Singers-Tabelle erstellt, für die die Ortsgruppe ssd_only verwendet wird. In der Spalte Awards wird diese Speicherebenenrichtlinie auf Tabellenebene jedoch überschrieben und die Lokalitätsgruppe spill_to_hdd wird als Speicherebenenrichtlinie 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), \
      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;"

Überschreibungsrichtlinie für die abgestufte Speicherverwaltung auf Ebene des sekundären Index festlegen

Sie können für Ihre Daten eine sekundäre Speicherrichtlinie für die Speicherebene auf Indexebene 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 Indexebene ein, um die Speicherebenenrichtlinie mit GoogleSQL oder PostgreSQL zu überschreiben.

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

    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 eine übergeordnete Richtlinie für die Speicherebene auf sekundärer Indexebene mit der gcloud CLI festzulegen.

Mit den folgenden DDL-Anweisungen wird beispielsweise eine Singers-Tabelle erstellt, für die die Ortsgruppe ssd_only verwendet wird. Außerdem wird in der Datenbank ein sekundärer Index für alle Singers in der Datenbank nach Vor- und Nachnamen erstellt. Der Index SingersByFirstLastName überschreibt die Speicherplatzbegrenzung auf Tabellenebene und verwendet die Lokalitätsgruppe spill_to_hdd als Speicherplatzbegrenzung:

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

Ortsgruppe auf Spaltenebene festlegen

Sie können für Ihre Daten eine Standortgruppe auf Spaltenebene festlegen, auch wenn für die Standortgruppe keine abgestufte Speicherrichtlinie gilt. 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 zugewiesen wird. Verwenden Sie dazu GoogleSQL oder PostgreSQL.

    Mit den folgenden DDL-Anweisungen wird beispielsweise eine Songs-Tabelle mit einer LyricsCompressed-Spalte erstellt, die separat in der Lokalitätsgruppe 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 Befehl der gcloud CLI eine Ortsgruppe 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 Lokalitätsgruppe 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 Verschieben von Daten kann bis zu sieben Tage dauern. Sie können den Fortschritt der Migration beobachten, indem Sie die integrierte SPANNER_SYS.TABLE_SIZES_STATS_1HOUR-Tabelle 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 eine Aufschlüsselung nach SSD und HDD für Ihre Datenbank oder Instanz aufzurufen. Weitere Informationen finden Sie unter Beobachtbarkeit von abgestuftem Speicher.

Daten von SSD- zu HDD-Speicher verschieben

Wenn Sie Daten von SSD- auf HDD-Speicher verschieben möchten, können Sie eine neue Speicherortgruppe mit einer altersbasierten abgestuften Speicherrichtlinie erstellen oder die abgestufte Speicherrichtlinie einer vorhandenen Speicherortgruppe ändern. Das Verschieben von Daten von einem SSD auf eine Festplatte kann bis zu sieben Tage dauern. Weitere Informationen finden Sie unter Altersabhängige Richtlinie für die Standortgruppe erstellen oder Speicheroption ändern.

Daten von einem HDD-Speicher auf einen SSD-Speicher verschieben

Wenn Sie Daten von einem HDD- zu einem SSD-Speicher verschieben möchten, können Sie die Speicheroption einer vorhandenen Standortgruppe ändern oder die von der Tabelle verwendete Standortgruppe ändern. Das Verschieben von Daten von einem SSD auf eine Festplatte kann bis zu sieben Tage dauern.

Lokalitätsgruppe ändern, die von einer Tabelle verwendet wird

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

    Mit den folgenden DDL-Anweisungen wird beispielsweise die von der Tabelle verwendete Lokalitätsgruppe Singers 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 Lokalitätsgruppe zu ändern, die von einer Tabelle mit dem gcloud CLI-Befehl verwendet wird.

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

Lokalitätsgruppe ändern, die von der Spalte einer Tabelle verwendet wird

Sie können die Ortsgruppe ändern, die für die Spalte einer Tabelle verwendet wird. Legen Sie dazu die Ortsgruppe in den Spaltenoptionen fest.

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 Lokalitätsgruppe mit GoogleSQL oder PostgreSQL geändert wird.

    Mit den folgenden DDL-Anweisungen wird beispielsweise die Lokalitätsgruppe geändert, die von der Spalte LastName der Tabelle verwendet wird, in 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. Klicken Sie auf Ausführen.

gcloud

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

Mit den folgenden DDL-Anweisungen wird beispielsweise die Ortsgruppe geändert, die von der Spalte LastName der Tabelle verwendet wird, in 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;"

Ortsgruppe ändern

Sie können eine Ortsgruppe ändern, indem Sie die Speicheroption oder die altersbasierte Richtlinie ändern.

Speicheroption ändern

Sie können die Speicheroption einer Standortgruppe 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 DDL-Anweisung ALTER LOCALITY GROUP mit GoogleSQL oder PostgreSQL ein.

    Mit den folgenden DDL-Anweisungen wird beispielsweise die Speicheroption der Lokalitätsgruppe 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 Lokalitätsgruppe 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, in der Daten auf dem 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 DDL-Anweisung ALTER LOCALITY GROUP mit GoogleSQL oder PostgreSQL ein.

    Mit den folgenden DDL-Anweisungen wird beispielsweise die altersbasierte Richtlinie der Lokalitätsgruppe spill_to_hdd geändert, indem die Zeitspanne, in der Daten im 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 Lokalitätsgruppe spill_to_hdd geändert, indem die Zeitspanne, in der Daten im 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 Ortsgruppe 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 Ortsgruppe ändern, die von der Tabelle verwendet wird.

Console

  1. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  2. Geben Sie die DDL-Anweisung DROP LOCALITY GROUP mit GoogleSQL oder PostgreSQL ein.

    So können Sie beispielsweise eine Ortsgruppe ssd_only erstellen:

    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 der gcloud CLI zu löschen.

Wenn Sie beispielsweise die Standortgruppe 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