DESCRIBE EXTERNAL VOLUME

외부 볼륨 의 속성을 설명합니다.

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

참고 항목:

ALTER EXTERNAL VOLUME , CREATE EXTERNAL VOLUME , DROP EXTERNAL VOLUME , SHOW EXTERNAL VOLUMES

구문

DESC[RIBE] EXTERNAL VOLUME <name>
Copy

매개 변수

name

설명할 외부 볼륨의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다(예: "My object"). 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

출력

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

열

설명

parent_property

상위 속성. 이 열에는 STORAGE_LOCATIONS 속성이 포함되어 있으며, 이 속성에는 명명된 클라우드 저장소 위치 집합이 들어 있습니다.

property

속성의 이름입니다. 이 열에는 다음 표에 나열된 속성이 포함될 수 있습니다.

property_type

속성 유형입니다.

property_value

속성에 할당된 값입니다.

property_default

기본 속성 값입니다.

property 열에는 외부 볼륨 오브젝트의 다음 속성을 포함할 수 있습니다.

속성

설명

comment

외부 볼륨에 대한 설명 세트(있는 경우)입니다.

allow_writes

외부 볼륨에 쓰기 작업이 허용되는지 여부를 지정합니다.

storage_location_n

외부 볼륨과 연결된 클라우드 저장소 위치에 대한 세부 정보로, 여기서 n 은 STORAGE_LOCATIONS 목록의 다른 위치와 위치를 구분하는 고유 번호(예: storage_location_1)입니다.

저장 위치 속성에 대한 자세한 내용은 CREATE EXTERNAL VOLUME 섹션을 참조하십시오.

active

외부 볼륨의 활성 저장소 위치 이름입니다.

액세스 제어 요구 사항

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

권한

오브젝트

참고

USAGE

외부 볼륨

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

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

사용법 노트

  • 이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.

예

외부 볼륨을 설명합니다.

DESC EXTERNAL VOLUME my_external_volume;
Copy

다음은 저장소가 1개인 외부 볼륨에 대한 DESCRIBE EXTERNAL VOLUME의 출력입니다. STORAGE_LOCATION_1 의 속성 값은 표시 목적으로 약어로 표시되었습니다.

+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+
| parent_property   | property           | property_type | property_value                                                                            | property_default |
|-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------|
|                   | ALLOW_WRITES       | Boolean       | true                                                                                      | true             |
| STORAGE_LOCATIONS | STORAGE_LOCATION_1 | String        | {"NAME":"my_storage_us_west","STORAGE_PROVIDER":"S3","STORAGE_BASE_URL":"s3://...", ...}  |                  |
| STORAGE_LOCATIONS | ACTIVE             | String        | my_storage_us_west                                                                        |                  |
+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+
언어: 한국어