DESCRIBE STORAGE LIFECYCLE POLICY

DESCRIBE STORAGE LIFECYCLE POLICY

스토리지 수명 주기 정책(Storage Lifecycle Policy)의 속성을 설명하는 명령어입니다. DESCRIBE는 DESC로 줄여서 쓸 수 있어요.

출처: 문서

본문

DESCRIBE STORAGE LIFECYCLE POLICY는 스토리지 수명 주기 정책의 속성을 설명합니다. 관련 명령어로 CREATE STORAGE LIFECYCLE POLICY, ALTER STORAGE LIFECYCLE POLICY, DROP STORAGE LIFECYCLE POLICY, SHOW STORAGE LIFECYCLE POLICIES가 있어요.

구문 (Syntax)

{ DESC | DESCRIBE } STORAGE LIFECYCLE POLICY <policy_name>

파라미터 (Parameters)

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

출력 (Output)

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

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

이 SQL 명령어를 실행하는 역할은 최소한 다음 권한 중 하나가 있어야 합니다.

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

사용 참고 사항 (Usage notes)

• 이 명령어의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 방식 모두 출력을 조회 가능한 결과 집합으로 취급합니다. 예를 들어 SHOW 명령어 출력에서 원하는 컬럼만 선택하거나 행을 필터링할 수 있어요.
• 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표 식별자로 사용하세요. 예를 들어 출력 컬럼 type을 선택하려면 SELECT "type"처럼 지정합니다. SHOW 명령어의 출력 컬럼 이름은 소문자이므로 큰따옴표 식별자를 반드시 사용해야 해요.
• 정책에 대해 아카이브 스토리지를 활성화한 적이 있다면, 명령어 출력의 archive_tier 속성은 설정되었던 아카이브 계층(COOL 또는 COLD)을 보여줍니다. ALTER STORAGE LIFECYCLE POLICY로 ARCHIVE_FOR_DAYS 파라미터를 해제해 아카이브 정책을 만료 정책으로 전환한 경우에도 마찬가지입니다. 아카이브 계층은 설정 후 변경할 수 없습니다.

예제 (Examples)

다음은 my_storage_lifecycle_policy라는 스토리지 수명 주기 정책을 설명하는 예제입니다.

DESCRIBE STORAGE LIFECYCLE POLICY example_slp;

출력:

+-----------------------------+----------------+-------------+------+------------------+
| name                        | signature      | return_type | body | archive_for_days |
|-----------------------------+----------------+-------------+------+------------------|
| MY_STORAGE_LIFECYCLE_POLICY | (ARG1 BOOLEAN) | BOOLEAN     | arg1 |              365 |
+-----------------------------+----------------+-------------+------+------------------+

더 알아보기 (Learn more)

• CREATE STORAGE LIFECYCLE POLICY
• ALTER STORAGE LIFECYCLE POLICY
• DROP STORAGE LIFECYCLE POLICY
• SHOW STORAGE LIFECYCLE POLICIES