DESCRIBE SNAPSHOT

DESCRIBE SNAPSHOT

블록 스토리지 볼륨 스냅샷(Snapshot)의 속성을 설명하는 명령어입니다. DESCRIBE는 DESC로 줄여서 쓸 수 있어요.

참고: 이 작업은 현재 Snowflake의 지원 정책 및 서비스 수준 계약에 설정된 Service Level 대상에 포함되지 않습니다.

출처: 문서

본문

DESCRIBE SNAPSHOT은 블록 스토리지 볼륨 스냅샷의 속성을 설명합니다. 관련 명령어로 CREATE SNAPSHOT, ALTER SNAPSHOT, DROP SNAPSHOT, SHOW SNAPSHOTS가 있어요.

구문 (Syntax)

{ DESC | DESCRIBE } SNAPSHOT <name>

파라미터 (Parameters)

• name — 설명할 스냅샷의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements를 참고하세요.

출력 (Output)

명령어 출력에는 객체의 속성과 메타데이터를 설명하는 다음 컬럼이 포함됩니다.

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 역할은 최소한 OWNERSHIP or USAGE 권한(객체: Snapshot)이 있어야 합니다. OWNERSHIP은 객체에 대한 특별한 권한으로, 객체를 생성한 역할에 자동으로 부여되지만 소유 역할(또는 MANAGE GRANTS 권한이 있는 역할)이 GRANT OWNERSHIP 명령어로 다른 역할에 이전할 수 있습니다.

스키마 안의 객체를 조작하려면 상위 데이터베이스에 대한 권한이 1개 이상, 상위 스키마에 대한 권한이 1개 이상 필요합니다. 지정된 권한 집합으로 커스텀 역할을 만드는 방법은 Creating custom roles을, securable 객체에 대한 역할과 권한 부여에 관한 일반 정보는 Overview of Access Control을 참고하세요.

사용 참고 사항 (Usage notes)

• 이 명령어의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 방식 모두 출력을 조회 가능한 결과 집합으로 취급합니다. 예를 들어 SHOW 명령어 출력에서 원하는 컬럼만 선택하거나 행을 필터링할 수 있어요.
• 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표 식별자로 사용하세요. 예를 들어 출력 컬럼 type을 선택하려면 SELECT "type"처럼 지정합니다. SHOW 명령어의 출력 컬럼 이름은 소문자이므로 큰따옴표 식별자를 반드시 사용해야 해요.

예제 (Examples)

다음은 my_snapshot이라는 스냅샷을 설명하는 예제입니다.

DESC SNAPSHOT my_snapshot;

출력:

+-------------+---------+---------------+-------------+----------------------------------------------------+-------------+----------+------+--------------+-----------+-----------------+-------------------------------+-------------------------------+---------------+
| name        | state   | database_name | schema_name | service_name                                       | volume_name | instance | size | comment      | owner     | owner_role_type | created_on                    | updated_on                    | encryption    |
|-------------+---------+---------------+-------------+----------------------------------------------------+-------------+----------+------+--------------+-----------+-----------------+-------------------------------+-------------------------------+---------------|
| MY_SNAPSHOT | CREATED | TUTORIAL_DB   | DATA_SCHEMA | TUTORIAL_DB.DATA_SCHEMA.MY_SERVICE_WITH_EBS_VOLUME | block-vol1  | 0        |   10 | new snapshot | TEST_ROLE | ROLE            | 2024-05-09 21:36:58.502 -0700 | 2024-05-09 21:38:03.424 -0700 | SNOWFLAKE_SSE |
+-------------+---------+---------------+-------------+----------------------------------------------------+-------------+----------+------+--------------+-----------+-----------------+-------------------------------+-------------------------------+---------------+

더 알아보기 (Learn more)

• CREATE SNAPSHOT
• ALTER SNAPSHOT
• DROP SNAPSHOT
• SHOW SNAPSHOTS