DESCRIBE STORAGE LIFECYCLE POLICY

:doc:`저장소 수명 주기 정책</user-guide/storage-management/storage-lifecycle-policies>`의 속성을 설명합니다.

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

참고 항목:

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

구문

{ DESC | DESCRIBE } STORAGE LIFECYCLE POLICY <policy_name>
Copy

매개 변수

policy_name

설명할 정책의 식별자를 지정합니다.

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

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

출력

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

열

설명

name

정책의 이름입니다.

signature

정책이 행의 만료 여부를 평가하는 데 사용하는 열입니다.

return_type

반환 값의 데이터 타입이 포함된 VARCHAR 값입니다. 예: BOOLEAN, NUMBER, ARRAY, OBJECT.

body

행이 만료되어야 하는지 여부를 평가하는 함수 본문입니다.

archive_tier

아카이브 저장소 계층(COOL또는 COLD)입니다.

archive_for_days

(선택 사항) 만료 전에 테이블 행을 보관할 일 수입니다. 이 속성이 설정되지 않은 경우 값은 NULL입니다.

액세스 제어 요구 사항

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

권한

오브젝트

참고

APPLY STORAGE LIFECYCLE POLICY

계정

계정의 모든 저장소 수명 주기 정책에 대해 DESC를 허용합니다.

APPLY

저장소 수명 주기 정책

저장소 수명 주기 정책에 DESC를 허용합니다.

OWNERSHIP

저장소 수명 주기 정책

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).

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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

보안 오브젝트 에 대해 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.

  • 정책에 대해 아카이브 저장소를 활성화한 적이 있는 경우 명령 출력의 archive_tier 속성은 설정된 아카이브 계층(COOL 또는 COLD)을 표시합니다. 이는 ALTER STORAGE LIFECYCLE POLICY를 통해 ARCHIVE_FOR_DAYS 매개 변수를 설정 해제하여 아카이브 정책을 만료 정책으로 전환하는 경우에도 마찬가지입니다. 아카이브 계층을 설정한 후에는 변경할 수 없습니다.

예

다음 예제에서는 이름이 ``my_storage_lifecycle_policy``인 저장소 수명 주기 정책을 설명합니다.

DESCRIBE STORAGE LIFECYCLE POLICY example_slp;
Copy

출력:

+-----------------------------+----------------+-------------+------+------------------+
| name                        | signature      | return_type | body | archive_for_days |
|-----------------------------+----------------+-------------+------+------------------|
| MY_STORAGE_LIFECYCLE_POLICY | (ARG1 BOOLEAN) | BOOLEAN     | arg1 |              365 |
+-----------------------------+----------------+-------------+------+------------------+
언어: 한국어