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 informasi tentang cara kerja penyimpanan berlapis, lihat Penyimpanan berlapis.

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.

Konsol

  1. Buka halaman Instance Spanner di konsol Google 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 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 waktu yang ditentukan. 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 tingkatan berbasis usia, jumlah waktu minimum yang 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 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 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 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 bertingkat 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 berlapisnya dari induknya, kecuali jika diganti secara eksplisit.

Menetapkan grup lokalitas tingkat database

Kebijakan penyimpanan bertingkat default adalah semua data disimpan di penyimpanan SSD. Anda dapat mengubah kebijakan penyimpanan tingkat database dengan mengubah grup lokalitas default. Untuk database dialek GoogleSQL, pernyataan DDL ALTER LOCALITY GROUP Anda 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 kosong.
  2. Masukkan pernyataan DDL ALTER LOCALITY GROUP menggunakan GoogleSQL atau PostgreSQL.

    Misalnya, pernyataan DDL berikut mengubah grup lokalitas default untuk menggunakan kebijakan penyimpanan berlapis 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 berlapis 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 tingkat tabel untuk data yang menggantikan kebijakan penyimpanan tingkat database.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor 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 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 tingkat penggantian level kolom

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

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor kosong.
  2. Masukkan pernyataan DDL CREATE TABLE dengan kebijakan penyimpanan tingkat bertingkat penggantian tingkat kolom menggunakan GoogleSQL atau PostgreSQL.

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

    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 tingkat 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 akan mengganti kebijakan penyimpanan tingkat tabel ini dan menggunakan grup lokalitas spill_to_hdd sebagai kebijakan penyimpanan tingkatnya:

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 tingkat penggantian tingkat indeks sekunder

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

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor kosong.
  2. Masukkan pernyataan DDL CREATE INDEX dengan kebijakan penyimpanan tingkat pengganti 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 di semua Singers dalam database berdasarkan nama depan dan belakang mereka. Indeks SingersByFirstLastName menggantikan kebijakan penyimpanan tingkat tabel dan menggunakan grup lokalitas spill_to_hdd sebagai kebijakan penyimpanan tingkatnya:

    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 tingkat 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 di semua Singers dalam database berdasarkan nama depan dan belakangnya. Indeks SingersByFirstLastName mengganti kebijakan penyimpanan berlapis tingkat tabel dan menggunakan grup lokalitas spill_to_hdd sebagai kebijakan penyimpanan berlapisnya:

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 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. Pemindahan 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 dalam 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 informasi selengkapnya, lihat observabilitas 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 tingkatan berbasis usia, atau mengubah kebijakan penyimpanan tingkatan dari grup lokalitas yang ada. Memindahkan data dari SSD ke HDD dapat memerlukan waktu hingga tujuh hari. 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. Memindahkan data dari SSD ke HDD dapat memerlukan waktu hingga tujuh hari.

Mengubah grup lokalitas yang digunakan oleh tabel

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

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor 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 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.

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 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 dari grup lokalitas dengan memperpanjang atau mempersingkat waktu penyimpanan data di SSD sebelum dipindahkan ke penyimpanan HDD.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor 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 penyimpanan data 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 penyimpanan data 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 grup tersebut berisi data. Anda harus terlebih dahulu memindahkan semua data yang ada di grup lokalitas ke grup lokalitas lain. Untuk informasi selengkapnya, lihat Mengubah grup lokalitas yang digunakan oleh tabel.

Konsol

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor 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