SHOW EXTERNAL VOLUMES¶
액세스 권한이 있는 계정의 외부 볼륨 을 나열합니다.
출력은 외부 볼륨 메타데이터와 속성을 반환합니다.
- 참고 항목:
CREATE EXTERNAL VOLUME , DROP EXTERNAL VOLUME , ALTER EXTERNAL VOLUME , DESCRIBE EXTERNAL VOLUME
구문¶
SHOW EXTERNAL VOLUMES [ LIKE '<pattern>' ]
매개 변수¶
LIKE 'pattern'오브젝트 이름으로 명령 출력을 선택적으로 필터링합니다. 이 필터는 SQL 와일드카드 문자(
%및_) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.예를 들어, 다음 패턴은 같은 결과를 반환합니다.
... LIKE '%testing%' ...... LIKE '%TESTING%' .... 기본값: 값 없음(출력에 필터링이 적용되지 않음).
액세스 제어 요구 사항¶
이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
|---|---|---|
USAGE |
외부 볼륨 |
SHOW EXTERNAL VOLUMES의 출력에서 특정 외부 볼륨을 보려면 역할에 해당 볼륨에 대한 USAGE 권한이 있어야 합니다. |
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.
이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.
출력¶
명령 출력은 다음 열에 테이블 속성 및 메타데이터를 제공합니다.
열 |
설명 |
|---|---|
|
외부 테이블의 이름입니다. |
|
Snowflake가 저장소 위치에 파일을 쓸 수 있는지 여부를 나타냅니다. |
|
외부 볼륨에 대한 설명입니다. |
예¶
모든 외부 볼륨을 표시합니다.
SHOW EXTERNAL VOLUMES;
볼 권한이 있는 aws 로 시작하는 이름을 가진 모든 외부 볼륨을 표시합니다.
SHOW EXTERNAL VOLUMES LIKE 'aws%';