CREATE SNAPSHOT

참고

이 작업은 현재 Snowflake의 지원 정책 및 서비스 수준 계약 에 명시된 서비스 수준에 포함되지 않습니다.

지정된 서비스 인스턴스에서 명명된 볼륨의 스냅샷 을 생성하거나 바꿉니다. 현재 스키마에 스냅샷이 생성됩니다.

참고 항목:

ALTER SNAPSHOT, DESCRIBE SNAPSHOT, DROP SNAPSHOT , SHOW SNAPSHOTS

구문

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>' [ , ... ] ) ]
Copy

필수 매개 변수

name

스냅샷의 식별자(즉, 이름)를 지정하는 문자열로, 스냅샷이 생성된 스키마에 대해 고유해야 합니다.

또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

FROM SERVICE service_name

서비스의 이름을 지정합니다.

VOLUME "volume_name"

서비스와 관련된 볼륨의 이름을 지정합니다. 스냅샷은 블록 저장소 볼륨에 대해서만 만들 수 있으며 로컬, 메모리 또는 스테이지 볼륨에 대해서는 만들 수 없습니다.

볼륨 이름은 대/소문자를 구분합니다. 따라서 서비스 사양에서 해당 이름과 일치하려면 항상 큰따옴표를 사용해야 합니다.

INSTANCE instance_id

서비스 인스턴스의 인덱스. 서비스 인스턴스 인덱스는 0에서 시작하며 범위는 [0, ...,  MAX_INSTANCES - 1] 입니다. SYSTEM$GET_SERVICE_STATUS — 사용되지 않음 함수를 호출하여 관련 정보를 얻을 수 있습니다.

선택적 매개 변수

COMMENT = 'string_literal'

서비스에 대한 설명을 지정합니다.

기본값: 값 없음

TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )

태그 이름과 태그 문자열 값을 지정합니다.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.

액세스 제어 요구 사항

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

CREATE SNAPSHOT

스키마

OPERATE

서비스

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

  • CREATE OR REPLACE <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.

볼륨 이름이 “데이터”인 인스턴스 2개(컨테이너 개수는 중요하지 않음)가 있는 서비스를 생성하는 경우, 다음 SQL을 사용하여 첫 번째 인스턴스와 연결된 볼륨의 스냅샷을 생성합니다.

CREATE SNAPSHOT snapshot_0
  FROM SERVICE example_service
  VOLUME "data"
  INSTANCE 0
  COMMENT='new snapshot';
Copy

두 번째 서비스 인스턴스와 연결된 볼륨의 스냅샷을 생성하려면 앞의 SQL에 INSTANCE 1 을 지정합니다.