DESCRIBE SNAPSHOT

참고

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

블록 저장소 볼륨 스냅샷 의 속성을 설명합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:

CREATE SNAPSHOT , ALTER SNAPSHOT, DROP SNAPSHOT, SHOW SNAPSHOTS

구문

{ DESC | DESCRIBE } SNAPSHOT <name>
Copy

매개 변수

name

설명할 스냅샷의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

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

출력

명령의 출력에는 오브젝트의 속성과 메타데이터를 설명하는 다음 열이 포함됩니다.

열

설명

name

스냅샷의 이름.

state

다음 값 중 하나로, 스냅샷의 현재 상태를 나타냅니다.

  • INITIALIZED: 스냅샷 생성이 진행 중입니다.

  • CREATED: 스냅샷이 생성되며 볼륨을 생성하는 데 사용할 수 있습니다.

  • ERROR: 스냅샷 생성에 실패했습니다.

database_name

스냅샷이 생성되는 데이터베이스입니다.

schema_name

스냅샷이 생성된 스키마입니다.

service_name

스냅샷이 생성되는 정규화된 서비스 이름입니다.

volume_name

스냅샷이 생성되는 지정된 서비스 인스턴스의 볼륨입니다.

instance

서비스 인스턴스의 ID입니다.

size

스냅샷의 크기(GB)입니다.

comment

스냅샷에 대한 일반 설명입니다.

owner

스냅샷을 소유한 역할입니다.

owner_role_type

오브젝트를 소유하는 역할의 유형(ROLE 또는 DATABASE_ROLE)입니다.

created_on

스냅샷이 생성된 날짜 및 시간입니다.

encryption

스냅샷이 생성된 볼륨에 대해 구성된 암호화 유형입니다. 가능한 값으로는 SNOWFLAKE_SSE 및 SNOWFLAKE_FULL 이 있습니다.

액세스 제어 요구 사항

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

권한

오브젝트

참고

OWNERSHIP 또는 USAGE

스냅샷

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한. 스키마에 대한 모든 권한이 부여된 역할은 스키마를 확인할 수 있습니다. 예를 들어, 스키마에 대해 CREATE 권한을 부여받은 역할은 해당 스키마에 대한 USAGE 권한을 함께 부여받지 않더라도 해당 스키마에 대한 오브젝트를 생성할 수 있습니다.

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

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

사용법 노트

  • 이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

예

다음 예제에서는 이름이 my_snapshot 인 스냅샷을 설명합니다.

DESC SNAPSHOT my_snapshot;
Copy

출력:

+-------------+---------+---------------+-------------+----------------------------------------------------+-------------+----------+------+--------------+-----------+-----------------+-------------------------------+-------------------------------+---------------+
| 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 |
+-------------+---------+---------------+-------------+----------------------------------------------------+-------------+----------+------+--------------+-----------+-----------------+-------------------------------+-------------------------------+---------------+
언어: 한국어