지역 그룹 만들기 및 관리하기

참고: 이 기능은 Spanner Enterprise 버전 및 Enterprise Plus 버전에서 사용 가능합니다. 자세한 내용은 Spanner 버전 개요를 참조하세요.

이 페이지에서는 Spanner 지역 그룹을 만들고 관리하는 방법을 설명합니다. 지역 그룹을 사용하여 데이터베이스 스키마의 데이터에 대한 계층형 스토리지 정책을 정의할 수 있습니다. 계층형 스토리지의 작동 방식에 관한 자세한 내용은 계층형 스토리지를 참고하세요.

지역 그룹 만들기

계층형 스토리지 정책 없이 지역 그룹을 만들거나 지역 그룹을 만들어 데이터베이스 스키마의 데이터에 대한 스토리지 정책을 정의할 수 있습니다.

콘솔

1. Google Cloud 콘솔에서 Spanner 인스턴스 페이지로 이동합니다.

   인스턴스

2. 계층형 스토리지를 사용할 인스턴스를 선택합니다.

3. 계층형 스토리지를 사용할 데이터베이스를 선택합니다.

4. 탐색 메뉴에서 Spanner 스튜디오를 클릭합니다.

5. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

6. GoogleSQL 또는 PostgreSQL을 사용하여 CREATE LOCALITY GROUP DDL 문을 입력합니다.

   예를 들어 다음을 실행하여 나머지 열의 데이터와 별도의 파일에 열을 저장하는 지역 그룹 separate_storage을 만들 수 있습니다.

   GoogleSQL

   CREATE LOCALITY GROUP separate_storage;
   

   PostgreSQL

   CREATE LOCALITY GROUP separate_storage;
   

   예를 들어 다음을 실행하여 SSD 스토리지에 데이터를 저장하는 지역 그룹 ssd_only를 만들 수 있습니다.

   GoogleSQL

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

   PostgreSQL

   CREATE LOCALITY GROUP ssd_only STORAGE 'ssd';
   

   예를 들어 다음을 실행하여 HDD 저장소에 데이터를 저장하는 지역 그룹 hdd_only을 만들 수 있습니다.

   GoogleSQL

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

   PostgreSQL

   CREATE LOCALITY GROUP hdd_only STORAGE 'hdd';
   

7. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 지역 그룹을 만들려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음을 실행하여 나머지 열의 데이터와 별도의 파일에 열을 저장하는 지역 그룹 separate_storage을 만들 수 있습니다.

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"

예를 들어 다음을 실행하여 SSD에 데이터를 저장하는 지역 그룹 ssd_only를 만들 수 있습니다.

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

예를 들어 다음을 실행하여 HDD 저장소에 데이터를 저장하는 지역 그룹 hdd_only을 만들 수 있습니다.

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

지역 그룹에 대한 연령 기반 정책 만들기

기간 기반 정책이 있는 지역 그룹은 SSD 스토리지에 새 데이터를 지정된 시간 동안 저장합니다. 지정된 시간이 지나면 Spanner는 일반적으로 지정된 시간으로부터 7일 이내에 발생하는 정상적인 압축 주기 중에 데이터를 HDD 스토리지로 이전합니다. 사용 기간 기반 계층형 스토리지 정책을 사용하는 경우 데이터가 HDD 스토리지로 이동하기 전에 SSD에 저장되어야 하는 최소 시간은 1시간입니다.

연령 기반 지역 그룹을 만들려면 CREATE LOCALITY GROUP DDL 문을 사용합니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 CREATE LOCALITY GROUP DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 처음 10일 동안 SSD 스토리지에 데이터를 저장한 다음 일반 압축 주기를 통해 이전 데이터를 HDD 스토리지로 이전하는 지역 그룹 spill_to_hdd를 만듭니다.

   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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 연령 기반 지역 그룹을 만들려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 처음 10일 동안 SSD에 데이터를 저장한 다음 일반 압축 주기를 통해 이전 데이터를 HDD로 이전하는 지역 그룹 spill_to_hdd를 만듭니다.

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

데이터에 계층형 스토리지 정책 설정

지역 그룹을 만든 후 데이터에 계층형 스토리지 정책을 설정할 수 있습니다. 계층형 스토리지 정책에 따라 데이터가 사용하는 지역 그룹이 결정됩니다. 데이터베이스, 테이블, 열 또는 보조 색인 수준에서 계층형 스토리지 정책을 설정할 수 있습니다. 각 데이터베이스 객체는 명시적으로 재정의되지 않는 한 상위 요소에서 계층형 스토리지 정책을 상속합니다.

데이터베이스 수준 지역 그룹 설정

기본 계층화된 스토리지 정책은 모든 데이터가 SSD 스토리지에 저장된다는 것입니다. default 지역 그룹을 변경하여 데이터베이스 수준 계층형 스토리지 정책을 변경할 수 있습니다. GoogleSQL 언어 데이터베이스의 경우 ALTER LOCALITY GROUP DDL 문에 백틱(`default`) 내에 default가 있어야 합니다. default 지역 그룹의 백틱만 포함하면 됩니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 ALTER LOCALITY GROUP DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 저장기간 기반 계층형 저장용량 정책을 사용하도록 default 지역 그룹을 변경합니다. 데이터베이스의 모든 데이터는 10일 후에 HDD 스토리지로 이동됩니다.

   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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 default 지역 그룹의 계층형 스토리지 정책을 변경하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 저장기간 기반 계층형 저장용량 정책을 사용하도록 default 지역 그룹을 변경합니다. 데이터베이스의 모든 데이터는 10일 후에 HDD 스토리지로 이동됩니다.

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

테이블 수준 지역 그룹 설정

데이터에 데이터베이스 수준 계층형 스토리지 정책을 재정의하는 테이블 수준 계층형 스토리지 정책을 설정할 수 있습니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 CREATE TABLE DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 지역 그룹 ssd_only를 사용하는 테이블 Singers를 만듭니다.

   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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 테이블 수준 계층형 스토리지 정책을 설정하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 지역 그룹 ssd_only를 사용하는 테이블 Singers를 만듭니다.

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

열 수준 재정의 계층형 스토리지 정책 설정

데이터에 열 수준 재정의 계층형 스토리지 정책을 설정할 수 있습니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 열 수준 재정의 계층형 스토리지 정책이 포함된 CREATE TABLE DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 지역 그룹 ssd_only를 사용하는 Singers 테이블을 만듭니다. 그러나 Awards 열은 이 테이블 수준 지역 그룹을 재정의하고 spill_to_hdd 지역 그룹을 계층화된 스토리지 정책으로 사용합니다.

   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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 열 수준 재정의 계층형 스토리지 정책을 설정하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 지역 그룹 ssd_only를 사용하는 Singers 테이블을 만듭니다. 그러나 Awards 열은 이 테이블 수준 계층형 스토리지 정책을 재정의하고 spill_to_hdd 지역 그룹을 계층형 스토리지 정책으로 사용합니다.

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

보조 색인 수준 재정의 계층형 스토리지 정책 설정

데이터에 보조 색인 수준 재정의 계층형 스토리지 정책을 설정할 수 있습니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 보조 색인 수준 재정의 계층형 스토리지 정책이 포함된 CREATE INDEX DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 지역 그룹 ssd_only를 사용하는 Singers 테이블을 만듭니다. 또한 데이터베이스에는 데이터베이스의 모든 Singers에 대해 이름과 성을 기준으로 한 보조 색인이 있습니다. SingersByFirstLastName 색인은 테이블 수준 계층형 스토리지 정책을 재정의하고 spill_to_hdd 지역 그룹을 계층형 스토리지 정책으로 사용합니다.

   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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 보조 색인 수준 재정의 계층형 스토리지 정책을 설정하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 지역 그룹 ssd_only를 사용하는 Singers 테이블을 만듭니다. 또한 데이터베이스는 데이터베이스의 모든 Singers에 대해 가수 이름과 성으로 보조 색인을 만듭니다. SingersByFirstLastName 색인은 테이블 수준 계층형 스토리지 정책을 재정의하고 spill_to_hdd 지역 그룹을 계층형 스토리지 정책으로 사용합니다.

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

열 수준 지역 그룹 설정

지역 그룹에 계층형 스토리지 정책이 없더라도 데이터에 열 수준 지역 그룹을 설정할 수 있습니다. 이 열에서 데이터를 읽는 것이 다른 열과 그룹화된 데이터를 읽는 것보다 빠릅니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 열을 지역 그룹에 할당하는 CREATE TABLE DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 hdd_only 지역 그룹에 별도로 저장되는 LyricsCompressed 열이 있는 Songs 테이블을 만듭니다.

   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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 데이터의 열 수준 지역 그룹을 설정하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 hdd_only 지역 그룹에 별도로 저장되는 LyricsCompressed 열이 있는 Songs 테이블을 만듭니다.

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;

스토리지 옵션 간에 데이터 이동

SSD와 HDD 스토리지 간에 데이터를 이동할 수 있습니다. 데이터를 이동하는 데 최대 7일이 걸릴 수 있습니다. 내장 SPANNER_SYS.TABLE_SIZES_STATS_1HOUR 테이블을 쿼리하여 데이터베이스의 각 테이블에 대한 HDD 및 SSD 스토리지 사용량을 확인하여 이동 진행 상황을 모니터링할 수 있습니다. Cloud Monitoring spanner.googleapis.com/instance/storage/used_bytes 측정항목을 사용하여 데이터베이스 또는 인스턴스의 SSD 및 HDD 분류를 표시하여 스토리지 사용량을 모니터링할 수도 있습니다. 자세한 내용은 계층화된 스토리지 관측 가능성을 참고하세요.

SSD에서 HDD 스토리지로 데이터 이동

SSD에서 HDD 스토리지로 데이터를 이동하려면 경과 시간 기반 계층형 스토리지 정책으로 새 지역 그룹을 만들거나 기존 지역 그룹의 계층형 스토리지 정책을 변경하면 됩니다. SSD에서 HDD로 데이터를 이동하는 데 최대 7일이 걸릴 수 있습니다. 자세한 내용은 지역 그룹에 대한 연령대별 정책 만들기 또는 저장소 옵션 변경을 참고하세요.

HDD에서 SSD 스토리지로 데이터 이동

HDD에서 SSD 스토리지로 데이터를 이동하려면 기존 지역 그룹의 스토리지 옵션을 변경하거나 테이블에서 사용하는 지역 그룹을 변경하면 됩니다. SSD에서 HDD로 데이터를 이동하는 데 최대 7일이 걸릴 수 있습니다.

테이블에서 사용하는 지역 그룹 변경

테이블 옵션에서 새 지역 그룹 또는 다른 지역 그룹을 설정하여 테이블에서 사용하는 지역 그룹을 변경할 수 있습니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 테이블에서 사용하는 지역 그룹을 변경하는 ALTER TABLE DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 테이블 Singers에서 사용하는 지역 그룹을 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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어를 사용하여 테이블에서 사용하는 지역 그룹을 변경하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 테이블 Singers에서 사용하는 지역 그룹을 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;"

테이블 열에서 사용하는 지역 그룹 변경

열 옵션에서 지역 그룹을 설정하여 테이블 열에서 사용하는 지역 그룹을 변경할 수 있습니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 테이블에서 사용하는 지역 그룹을 변경하는 ALTER TABLE DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 테이블의 열 LastName에서 사용하는 지역 그룹을 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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어를 사용하여 테이블에서 사용하는 지역 그룹을 변경하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 테이블의 열 LastName에서 사용하는 지역 그룹을 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;"

지역 그룹 변경

저장소 옵션을 변경하거나 연령별 정책을 변경하여 지역 그룹을 변경할 수 있습니다.

저장용량 옵션 변경

지역 그룹의 스토리지 옵션을 SSD에서 HDD로 또는 HDD에서 SSD로 변경할 수 있습니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 ALTER LOCALITY GROUP DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 지역 그룹 separate_storage의 저장소 옵션을 HDD로 변경합니다.

   GoogleSQL

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

   PostgreSQL

   ALTER LOCALITY GROUP separate_storage STORAGE 'hdd';
   

3. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 지역 그룹의 스토리지 옵션을 변경하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 지역 그룹 separate_storage의 저장소 옵션을 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';"

기간 기반 정책 변경

데이터가 HDD 스토리지로 이동하기 전에 SSD에 저장되는 시간을 연장하거나 단축하여 지역 그룹의 기간 기반 정책을 변경할 수 있습니다.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 ALTER LOCALITY GROUP DDL 문을 입력합니다.

   예를 들어 다음 DDL 문은 데이터가 SSD에 저장되는 기간을 20일로 연장하여 지역 그룹 spill_to_hdd의 저장기간 기준 정책을 변경합니다.

   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. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 지역 그룹의 연령 기반 정책을 변경하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 다음 DDL 문은 데이터가 SSD에 저장되는 기간을 20일로 연장하여 지역 그룹 spill_to_hdd의 저장기간 기준 정책을 변경합니다.

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

지역 그룹 삭제

데이터가 포함된 지역 그룹은 삭제할 수 없습니다. 먼저 지역 그룹에 있는 모든 데이터를 다른 지역 그룹으로 이동해야 합니다. 자세한 내용은 테이블에서 사용하는 지역 그룹 변경을 참고하세요.

콘솔

1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.

2. GoogleSQL 또는 PostgreSQL을 사용하여 DROP LOCALITY GROUP DDL 문을 입력합니다.

   예를 들어 다음을 실행하여 지역 그룹 ssd_only를 삭제할 수 있습니다.

   GoogleSQL

   DROP LOCALITY GROUP ssd_only;
   

   PostgreSQL

   DROP LOCALITY GROUP ssd_only;
   

3. 실행을 클릭합니다.

gcloud

gcloud CLI 명령어로 지역 그룹을 삭제하려면 gcloud spanner databases ddl update를 사용합니다.

예를 들어 지역 그룹 ssd_only을 삭제하려면 다음을 실행합니다.

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"

다음 단계

• 계층형 스토리지에 대해 자세히 알아보세요.
• 지역 그룹에 대해 자세히 알아보세요.
• 타임스탬프 조건자 푸시다운을 사용한 쿼리 최적화에 대해 자세히 알아보세요.