DESCRIBE EXTERNAL VOLUME
DESCRIBE EXTERNAL VOLUME
DESCRIBE EXTERNAL VOLUME 명령은 외부 볼륨(external volume)의 속성을 설명하는 명령이에요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.
본문
외부 볼륨의 속성을 설명하는 명령입니다. DESCRIBE는 DESC로 줄여 쓸 수 있어요.
관련 명령: ALTER EXTERNAL VOLUME, CREATE EXTERNAL VOLUME, DROP EXTERNAL VOLUME, SHOW EXTERNAL VOLUMES
Syntax
DESC[RIBE] EXTERNAL VOLUME <name>
Parameters
name— 설명할 외부 볼륨의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다 (예:"My object"). 큰따옴표로 감싼 식별자는 대소문자를 구분해요.
Output (출력)
명령 출력에는 객체의 속성과 메타데이터를 설명하는 다음 컬럼이 포함돼요.
property 컬럼은 외부 볼륨 객체의 다음 속성을 포함할 수 있어요.
- 외부 볼륨과 연결된 클라우드 스토리지 위치에 대한 세부 정보. 여기서
n은STORAGE_LOCATIONS목록에서 해당 위치를 다른 위치와 구분하는 고유 번호예요. 예:storage_location_1. 스토리지 위치 속성에 대한 자세한 내용은 CREATE EXTERNAL VOLUME 문서를 참고하세요.
Access control requirements (접근 제어 요구 사항)
이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.
지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.
Examples (예제)
외부 볼륨을 설명해 봅시다.
DESC EXTERNAL VOLUME my_external_volume;
다음은 스토리지 위치가 하나인 외부 볼륨의 DESCRIBE EXTERNAL VOLUME 출력을 보여줘요. STORAGE_LOCATION_1의 property value는 표시 목적으로 축약되었습니다.
+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+
| 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 | |
+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+