SHOW EXTERNAL VOLUMES

SHOW EXTERNAL VOLUMES

SHOW EXTERNAL VOLUMES 명령은 접근 권한(privilege)이 있는 계정의 외부 볼륨(external volume) 목록을 보여주는 명령이에요. 외부 볼륨은 Snowflake 외부의 스토리지 위치를 참조하는 객체로, 이 명령으로 정의된 볼륨들을 확인할 수 있어요.

출처: 문서

본문

이 명령은 접근 권한이 있는 계정의 외부 볼륨을 나열해요. 출력은 외부 볼륨 메타데이터와 속성을 반환해요.

관련 명령: CREATE EXTERNAL VOLUME, DROP EXTERNAL VOLUME, ALTER EXTERNAL VOLUME, DESCRIBE EXTERNAL VOLUME.

구문 (Syntax)

SHOW EXTERNAL VOLUMES [ LIKE '<pattern>' ]

파라미터 (Parameters)

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 역할은 최소한 다음 권한을 가져야 해요:

권한 (Privilege) 객체 (Object) 비고
USAGE 외부 볼륨 SHOW EXTERNAL VOLUMES 출력에서 특정 외부 볼륨을 보려면 역할이 그 외부 볼륨에 대한 USAGE 권한을 가져야 해요.

출력 (Output)

명령 출력은 다음 컬럼을 포함해요:

  • name — 외부 볼륨 이름.
  • allow_writes — Snowflake가 스토리지 위치에 파일을 쓸 수 있는지 여부.
  • comment — 외부 볼륨에 대한 주석.

사용 참고 사항 (Usage notes)

  • 실행에 실행 중인 웨어하우스를 요구하지 않아요.
  • 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

예제 (Examples)

모든 외부 볼륨을 표시해요:

SHOW EXTERNAL VOLUMES;

이름이 aws로 시작하는 외부 볼륨을 표시해요:

SHOW EXTERNAL VOLUMES LIKE 'aws%';

더 알아보기 (Learn more)