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`	외부 볼륨의 활성 저장소 위치 이름입니다.

액세스 제어 요구 사항¶

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

권한	오브젝트	참고
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.

예¶

외부 볼륨을 설명합니다.

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                                                                        |                  |
+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+