Membuat dan mengelola grup lokalitas

Halaman ini menjelaskan cara membuat dan mengelola grup lokalitas Spanner. Anda dapat menggunakan grup lokalitas untuk menentukan kebijakan penyimpanan bertingkat untuk data dalam skema database Anda. Untuk mengetahui informasi tentang cara kerja penyimpanan bertingkat, lihat Penyimpanan bertingkat.

Membuat grup lokalitas

Anda dapat membuat grup lokalitas tanpa kebijakan penyimpanan bertingkat, atau Anda dapat membuat grup lokalitas untuk menentukan kebijakan penyimpanan data dalam skema database Anda.

Jika Anda membuat grup lokalitas tanpa kebijakan penyimpanan bertingkat, grup lokalitas akan mewarisi kebijakan penyimpanan bertingkat dari grup lokalitas default. Jika Anda belum menyetel kebijakan penyimpanan grup lokalitas default secara manual, maka kebijakan penyimpanan akan disetel ke khusus SSD.

Konsol

  1. Buka halaman Instances Spanner di konsolGoogle Cloud .

    Instance

  2. Pilih instance tempat Anda ingin menggunakan penyimpanan bertingkat.

  3. Pilih database tempat Anda ingin menggunakan penyimpanan bertingkat.

  4. Di menu navigasi, klik Spanner Studio.

  5. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  6. Masukkan pernyataan DDL CREATE LOCALITY GROUP menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, Anda dapat menjalankan perintah berikut untuk membuat grup lokalitas, separate_storage, yang menyimpan kolom dalam file terpisah dari data untuk kolom lainnya:

    GoogleSQL 

    CREATE LOCALITY GROUP separate_storage;

    PostgreSQL 

    CREATE LOCALITY GROUP separate_storage;

    Misalnya, Anda dapat menjalankan perintah berikut untuk membuat grup lokalitas, ssd_only, yang menyimpan data di penyimpanan SSD:

    GoogleSQL 

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

    PostgreSQL 

    CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';

    Misalnya, Anda dapat menjalankan perintah berikut untuk membuat grup lokalitas, hdd_only, yang menyimpan data di penyimpanan HDD:

    GoogleSQL 

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

    PostgreSQL 

    CREATE LOCALITY GROUP hdd_only STORAGE 'hdd';

  7. Klik Run.

gcloud

Untuk membuat grup lokalitas dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, Anda dapat menjalankan perintah berikut untuk membuat grup lokalitas, separate_storage, yang menyimpan kolom dalam file terpisah dari data untuk kolom lainnya:

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"

Misalnya, Anda dapat menjalankan perintah berikut untuk membuat grup lokalitas, ssd_only, yang menyimpan data di 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'"

Misalnya, Anda dapat menjalankan perintah berikut untuk membuat grup lokalitas, hdd_only, yang menyimpan data di penyimpanan HDD:

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

Membuat kebijakan berbasis usia untuk grup lokalitas

Grup lokalitas dengan kebijakan berbasis usia menyimpan data yang lebih baru di penyimpanan SSD selama jangka waktu tertentu. Setelah waktu yang ditentukan berlalu, Spanner akan memigrasikan data ke penyimpanan HDD selama siklus pemadatan normalnya, yang biasanya terjadi selama tujuh hari sejak waktu yang ditentukan. Saat menggunakan kebijakan penyimpanan bertingkat berbasis usia, jumlah waktu minimum data harus disimpan di SSD sebelum dipindahkan ke penyimpanan HDD adalah satu jam.

Untuk membuat grup lokalitas berbasis usia, gunakan pernyataan DDL CREATE LOCALITY GROUP.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL CREATE LOCALITY GROUP menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut membuat grup lokalitas, spill_to_hdd, yang menyimpan data di penyimpanan SSD selama 10 hari pertama, lalu memigrasikan data yang lebih lama ke penyimpanan HDD selama siklus pemadatan normal:

    GoogleSQL 

    CREATE LOCALITY GROUP spill_to_hdd
OPTIONS (storage = 'ssd', ssd_to_hdd_spill_timespan = '10d');

    PostgreSQL 

    CREATE LOCALITY GROUP spill_to_hdd
STORAGE 'ssd' SSD_TO_HDD_SPILL_TIMESPAN '10d';

  3. Klik Run.

gcloud

Untuk membuat grup lokalitas berbasis usia dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut membuat grup lokalitas spill_to_hdd yang menyimpan data di SSD selama 10 hari pertama, lalu memigrasikan data yang lebih lama ke HDD selama siklus pemadatan 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'"

Menetapkan kebijakan penyimpanan bertingkat untuk data Anda

Setelah membuat grup lokalitas, Anda dapat menetapkan kebijakan penyimpanan bertingkat untuk data Anda. Kebijakan penyimpanan berjenjang menentukan grup lokalitas yang digunakan data. Anda dapat menetapkan kebijakan penyimpanan bertingkat di tingkat database, tabel, kolom, atau indeks sekunder. Setiap objek database mewarisi kebijakan penyimpanan bertingkatnya dari induknya, kecuali jika secara eksplisit diganti.

Jika Anda membuat grup lokalitas tanpa kebijakan penyimpanan bertingkat, grup lokalitas akan mewarisi kebijakan penyimpanan bertingkat dari grup lokalitas default. Jika Anda belum menyetel kebijakan penyimpanan grup lokalitas default secara manual, maka kebijakan penyimpanan akan disetel ke khusus SSD.

Menetapkan grup lokalitas tingkat database

Kebijakan penyimpanan bertingkat default adalah semua data disimpan di penyimpanan SSD. Anda dapat mengubah kebijakan penyimpanan bertingkat tingkat database dengan mengubah grup lokalitas default. Untuk database dialek GoogleSQL, pernyataan DDL ALTER LOCALITY GROUP harus memiliki default dalam tanda petik terbalik (`default`). Anda hanya perlu menyertakan tanda petik terbalik untuk grup lokalitas default.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL ALTER LOCALITY GROUP menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut mengubah grup lokalitas default untuk menggunakan kebijakan penyimpanan bertingkat berbasis usia. Semua data dalam database dipindahkan ke penyimpanan HDD setelah 10 hari.

    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. Klik Run.

gcloud

Untuk mengubah kebijakan penyimpanan bertingkat dari grup lokalitas default dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut mengubah grup lokalitas default untuk menggunakan kebijakan penyimpanan bertingkat berbasis usia. Semua data dalam database dipindahkan ke penyimpanan HDD setelah 10 hari.

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

Menetapkan grup lokalitas tingkat tabel

Anda dapat menetapkan kebijakan penyimpanan bertingkat tingkat tabel untuk data yang menggantikan kebijakan penyimpanan bertingkat tingkat database. Kebijakan penyimpanan bertingkat tingkat tabel juga berlaku untuk semua kolom dalam tabel, kecuali jika Anda telah menetapkan kebijakan penyimpanan bertingkat penggantian tingkat kolom.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL CREATE TABLE menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut membuat tabel, Singers, yang menggunakan grup lokalitas ssd_only:

    GoogleSQL 

    CREATE TABLE Singers (
  SingerId   INT64 NOT NULL,
  FirstName  STRING(1024),
  LastName   STRING(1024),
  SingerInfo BYTES(MAX)
) PRIMARY KEY (SingerId), OPTIONS (locality_group = 'ssd_only');

    PostgreSQL 

    CREATE TABLE Singers (
  SingerId   bigint PRIMARY KEY,
  FirstName  varchar(1024),
  LastName   varchar(1024),
  SingerInfo bytea
) LOCALITY GROUP ssd_only;

  3. Klik Run.

gcloud

Untuk menetapkan kebijakan penyimpanan bertingkat tingkat tabel dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut membuat tabel, Singers, yang menggunakan grup lokalitas 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;"

Menetapkan kebijakan penyimpanan bertingkat penggantian tingkat kolom

Anda dapat menetapkan kebijakan penyimpanan bertingkat penggantian tingkat kolom untuk data Anda.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL CREATE TABLE dengan kebijakan penyimpanan bertingkat penggantian tingkat kolom menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut membuat tabel Singers yang menggunakan grup lokalitas ssd_only. Namun, kolom Awards menggantikan grup lokalitas tingkat tabel ini dan menggunakan grup lokalitas spill_to_hdd sebagai kebijakan penyimpanan bertingkatnya:

    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. Klik Run.

gcloud

Untuk menetapkan kebijakan penyimpanan bertingkat penggantian tingkat kolom dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut membuat tabel Singers yang menggunakan grup lokalitas ssd_only. Namun, kolom Awards menggantikan kebijakan penyimpanan bertingkat tingkat tabel ini dan menggunakan grup lokalitas spill_to_hdd sebagai kebijakan penyimpanan bertingkatnya:

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

Menetapkan kebijakan penyimpanan bertingkat penggantian tingkat indeks sekunder

Anda dapat menetapkan kebijakan penyimpanan bertingkat penggantian tingkat indeks sekunder untuk data Anda.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL CREATE INDEX dengan kebijakan penyimpanan bertingkat penggantian tingkat indeks sekunder menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut membuat tabel Singers yang menggunakan grup lokalitas ssd_only. Database juga memiliki indeks sekunder pada semua Singers dalam database berdasarkan nama depan dan belakangnya. Indeks SingersByFirstLastName menggantikan kebijakan penyimpanan bertingkat tingkat tabel dan menggunakan grup lokalitas spill_to_hdd sebagai kebijakan penyimpanan bertingkatnya:

    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. Klik Run.

gcloud

Untuk menetapkan kebijakan penyimpanan bertingkat penggantian tingkat indeks sekunder dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut membuat tabel Singers yang menggunakan grup lokalitas ssd_only. Database juga membuat indeks sekunder pada semua Singers dalam database berdasarkan nama depan dan belakangnya. Indeks SingersByFirstLastName menggantikan kebijakan penyimpanan bertingkat tingkat tabel dan menggunakan grup lokalitas spill_to_hdd sebagai kebijakan penyimpanan bertingkatnya:

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

Menetapkan grup lokalitas tingkat kolom

Anda dapat menetapkan grup lokalitas tingkat kolom untuk data Anda meskipun grup lokalitas tidak memiliki kebijakan penyimpanan bertingkat. Membaca data dari kolom ini lebih cepat daripada membaca data yang dikelompokkan dengan kolom lain.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL CREATE TABLE yang menetapkan kolom ke grup lokalitas menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut membuat tabel Songs dengan kolom LyricsCompressed yang disimpan secara terpisah dalam grup lokalitas hdd_only:

    GoogleSQL 

    CREATE TABLE Songs (
  SingerId INT64 NOT NULL,
  SongId INT64 NOT NULL,
  Title STRING(MAX),
  Description STRING(MAX),
  LyricsCompressed BYTES(MAX) OPTIONS (locality_group = 'hdd_only')
) PRIMARY KEY (SingerId, SongId),
  INTERLEAVE IN PARENT Singers ON DELETE CASCADE,
  OPTIONS (locality_group = 'ssd_only');

    PostgreSQL 

    CREATE TABLE Songs (
  SingerId BIGINT NOT NULL,
  SongId BIGINT NOT NULL,
  Title VARCHAR,
  Description TEXT,
  LyricsCompressed BYTEA LOCALITY GROUP hdd_only,
  PRIMARY KEY (SingerId, SongId)
) LOCALITY GROUP ssd_only INTERLEAVE IN PARENT Singers ON DELETE CASCADE;

  3. Klik Run.

gcloud

Untuk menetapkan grup lokalitas tingkat kolom untuk data Anda dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut membuat tabel Songs dengan kolom LyricsCompressed yang disimpan secara terpisah dalam grup lokalitas 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;

Memindahkan data antar-opsi penyimpanan

Anda dapat memindahkan data antara penyimpanan SSD dan HDD. Memindahkan data dapat memerlukan waktu hingga tujuh hari. Anda dapat memantau progres pemindahan dengan membuat kueri tabel SPANNER_SYS.TABLE_SIZES_STATS_1HOUR bawaan untuk memeriksa penggunaan penyimpanan HDD dan SSD untuk setiap tabel di database Anda. Anda juga dapat memantau penggunaan penyimpanan dengan menggunakan metrik spanner.googleapis.com/instance/storage/used_bytes Cloud Monitoring untuk menampilkan perincian SSD dan HDD untuk database atau instance Anda. Untuk mengetahui informasi selengkapnya, lihat kemampuan pengamatan penyimpanan bertingkat.

Memindahkan data dari penyimpanan SSD ke HDD

Untuk memindahkan data dari penyimpanan SSD ke HDD, Anda dapat membuat grup lokalitas baru dengan kebijakan penyimpanan bertingkat berbasis usia, atau mengubah kebijakan penyimpanan bertingkat dari grup lokalitas yang ada. Spanner memindahkan data selama siklus pemadatan normalnya, yang biasanya terjadi selama tujuh hari. Jika Anda memuat data dan memperbarui grup lokalitas menggunakan salah satu pernyataan DDL ALTER berikut, Anda harus menunggu hingga tujuh hari agar perubahan pada grup lokalitas selesai:

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 ...

Periode tunggu tidak berlaku jika Anda membuat tabel, kolom, atau indeks baru, dan menambahkan grup lokalitas sebagai bagian dari sintaksis CREATE atau ADD COLUMN.

Untuk mengetahui informasi selengkapnya, lihat Membuat kebijakan berbasis usia untuk grup lokalitas atau Mengubah opsi penyimpanan.

Memindahkan data dari penyimpanan HDD ke SSD

Untuk memindahkan data dari penyimpanan HDD ke SSD, Anda dapat mengubah opsi penyimpanan grup lokalitas yang ada atau mengubah grup lokalitas yang digunakan oleh tabel. Spanner memindahkan data selama siklus pemadatan normalnya, yang biasanya terjadi selama tujuh hari. Jika Anda memuat data dan memperbarui grup lokalitas menggunakan salah satu pernyataan DDL ALTER berikut, Anda harus menunggu hingga tujuh hari agar perubahan pada grup lokalitas selesai:

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 ...

Periode tunggu tidak berlaku jika Anda membuat tabel, kolom, atau indeks baru, dan menambahkan grup lokalitas sebagai bagian dari sintaksis CREATE atau ADD COLUMN.

Mengubah grup lokalitas yang digunakan oleh tabel

Anda dapat mengubah grup lokalitas yang digunakan oleh tabel dengan menetapkan grup lokalitas baru atau berbeda di opsi tabel.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL ALTER TABLE yang mengubah grup lokalitas yang digunakan oleh tabel menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut mengubah grup lokalitas yang digunakan oleh tabel, Singers, menjadi spill_to_hdd:

    GoogleSQL 

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

    PostgreSQL 

    ALTER TABLE Singers SET LOCALITY GROUP spill_to_hdd;

  3. Klik Run.

gcloud

Untuk mengubah grup lokalitas yang digunakan oleh tabel dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut mengubah grup lokalitas yang digunakan oleh tabel, Singers, menjadi 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;"

Mengubah grup lokalitas yang digunakan oleh kolom tabel

Anda dapat mengubah grup lokalitas yang digunakan oleh kolom tabel dengan menetapkan grup lokalitas di opsi kolom.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL ALTER TABLE yang mengubah grup lokalitas yang digunakan oleh tabel menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut mengubah grup lokalitas yang digunakan oleh kolom tabel, LastName, menjadi 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. Klik Run.

gcloud

Untuk mengubah grup lokalitas yang digunakan oleh tabel dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut mengubah grup lokalitas yang digunakan oleh kolom tabel, LastName, menjadi 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;"

Mengubah grup lokalitas

Anda dapat mengubah grup lokalitas dengan mengubah opsi penyimpanannya atau mengubah kebijakan berbasis usianya. Spanner memindahkan data selama siklus pemadatan normalnya, yang biasanya terjadi selama tujuh hari. Jika Anda memuat data dan memperbarui grup lokalitas menggunakan ALTER LOCALITY GROUP, Anda harus menunggu hingga tujuh hari agar data yang ada dimigrasikan. Setelan yang diperbarui berlaku untuk semua data baru yang ditulis ke grup lokalitas tersebut secara langsung.

Mengubah opsi penyimpanan

Anda dapat mengubah opsi penyimpanan grup lokalitas dari SSD ke HDD atau HDD ke SSD.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL ALTER LOCALITY GROUP menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut mengubah opsi penyimpanan grup lokalitas, separate_storage, menjadi HDD:

    GoogleSQL 

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

    PostgreSQL 

    ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';

  3. Klik Run.

gcloud

Untuk mengubah opsi penyimpanan grup lokalitas dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut mengubah opsi penyimpanan grup lokalitas, separate_storage, menjadi 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';"

Mengubah kebijakan berbasis usia

Anda dapat mengubah kebijakan berbasis usia grup lokalitas dengan memperpanjang atau memperpendek waktu penyimpanan data di SSD sebelum dipindahkan ke penyimpanan HDD.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL ALTER LOCALITY GROUP menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut mengubah kebijakan berbasis usia grup lokalitas, spill_to_hdd, dengan memperpanjang durasi data disimpan di SSD menjadi 20 hari:

    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. Klik Run.

gcloud

Untuk mengubah kebijakan berbasis usia grup lokalitas dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, pernyataan DDL berikut mengubah kebijakan berbasis usia grup lokalitas, spill_to_hdd, dengan memperpanjang durasi data disimpan di SSD menjadi 20 hari:

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

Menghapus grup lokalitas

Anda tidak dapat menghapus grup lokalitas jika berisi data. Anda harus memindahkan semua data yang ada di grup lokalitas ke grup lokalitas lain terlebih dahulu. Untuk mengetahui informasi selengkapnya, lihat Mengubah grup lokalitas yang digunakan oleh tabel.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

  2. Masukkan pernyataan DDL DROP LOCALITY GROUP menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, Anda dapat menjalankan perintah berikut untuk menghapus grup lokalitas ssd_only:

    GoogleSQL 

    DROP LOCALITY GROUP ssd_only;

    PostgreSQL 

    DROP LOCALITY GROUP ssd_only;

  3. Klik Run.

gcloud

Untuk menghapus grup lokalitas dengan perintah gcloud CLI, gunakan gcloud spanner databases ddl update.

Misalnya, untuk menghapus grup lokalitas ssd_only, jalankan:

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"

Langkah berikutnya