CREATE SNAPSHOT
CREATE SNAPSHOT
CREATE SNAPSHOT 명령은 지정된 볼륨과 서비스 인스턴스에 대해 블록 스토리지 볼륨의 스냅샷을 만들거나 교체하는 명령이에요. 스냅샷은 현재 스키마에 생성됩니다.
출처: CREATE SNAPSHOT
본문
지정된 볼륨과 서비스 인스턴스에 대해 블록 스토리지 볼륨의 스냅샷을 만들거나 교체하는 명령입니다. 스냅샷은 현재 스키마에 생성돼요. Feature — Generally Available — Snowpark Container Services는 일부 예외를 제외하고 AWS, Microsoft Azure, Google Cloud Platform 상용 리전의 계정에서 사용할 수 있어요.
참고 이 작업은 현재 Snowflake 지원 정책과 서비스 수준 계약(SLA)에 명시된 서비스 수준으로는 다루어지지 않습니다.
관련 명령: ALTER SNAPSHOT, DESCRIBE SNAPSHOT, DROP SNAPSHOT, SHOW SNAPSHOTS
Syntax
CREATE [ OR REPLACE ] SNAPSHOT [ IF NOT EXISTS ] <name>
FROM SERVICE <service_name>
VOLUME "<volume_name>"
INSTANCE <instance_id>
[ COMMENT = '<string_literal>']
[ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
Required parameters (필수 파라미터)
name— 스냅샷의 식별자(이름)를 지정하는 문자열이에요. 스냅샷이 생성되는 스키마 내에서 고유해야 합니다. 또한 식별자는 알파벳 문자로 시작해야 하고, 전체 식별자 문자열을 큰따옴표로 감싸지 않는 한 공백이나 특수 문자를 포함할 수 없어요 (예:"My object"). 큰따옴표로 감싼 식별자는 대소문자를 구분합니다. 자세한 내용은 Identifier requirements 문서를 참고하세요.service_name— 서비스의 이름을 지정해요.volume_name— 서비스와 연결된 볼륨의 이름을 지정해요. 스냅샷은 블록 스토리지 볼륨에 대해서만 찍을 수 있으며(local, memory, stage 볼륨은 불가) 볼륨 이름은 대소문자를 구분하므로 서비스 사양의 해당 이름과 일치하도록 큰따옴표를 항상 사용해야 해요.instance_id— 서비스 인스턴스의 인덱스예요. 서비스 인스턴스 인덱스는 0에서 시작하며 범위는[0, ..., MAX_INSTANCES - 1]입니다. 관련 정보는SYSTEM$GET_SERVICE_STATUS— Deprecated 함수를 호출해 얻을 수 있어요.
Optional parameters (선택 파라미터)
COMMENT = '<string_literal>'— 서비스에 대한 주석을 지정해요. 기본값: 값 없음TAG ( <tag_name> = '<tag_value>' [ , ... ] )— 태그 이름과 태그 문자열 값을 지정해요. 태그 값은 항상 문자열이며 태그 값의 최대 문자 수는 256이에요. 문에서 태그를 지정하는 방법은 Tag quotas 문서를 참고하세요.
Access control requirements (접근 제어 요구 사항)
이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.
스키마의 객체를 조작하려면 상위 데이터베이스에 대한 권한과 상위 스키마에 대한 권한이 각각 최소 하나씩 필요합니다. 지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.
Usage notes (사용 참고 사항)
스냅샷은 블록 스토리지 볼륨의 특정 시점 복사본이에요. 스냅샷은 서비스의 블록 스토리지 볼륨에 대해서만 찍을 수 있습니다.
Examples (예제)
"data"라는 볼륨을 가진 두 개의 인스턴스(컨테이너 수는 무관)가 있는 서비스를 만들었다면, 다음 SQL로 첫 번째 인스턴스와 연결된 볼륨의 스냅샷을 만들 수 있어요.
CREATE SNAPSHOT snapshot_0
FROM SERVICE example_service
VOLUME "data"
INSTANCE 0
COMMENT='new snapshot';
두 번째 서비스 인스턴스와 연결된 볼륨의 스냅샷을 만들려면 앞의 SQL에서 INSTANCE 1을 지정해요.