SHOW EXTERNAL CONSUMERS

SHOW EXTERNAL CONSUMERS

SHOW EXTERNAL CONSUMERS 명령은 계정에 정의된 외부 소비자(external consumer) 목록을 보여주는 명령이에요. 외부 소비자는 Snowflake 외부에서 데이터를 소비하는 애플리케이션을 나타내며, 이 명령으로 정의된 소비자들을 확인할 수 있어요.

출처: 문서

본문

이 명령은 계정에 정의된 외부 소비자를 나열해요.

프리뷰 기능 (오픈): 모든 계정에서 사용 가능.

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

구문 (Syntax)

SHOW EXTERNAL CONSUMERS [ LIKE '<pattern>' ]

파라미터 (Parameters)

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

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

모든 역할이 이 명령을 실행할 수 있어요. 결과는 현재 역할이 볼 권한이 있는 외부 소비자만 표시하도록 필터링돼요.

사용 참고 사항 (Usage notes)

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

예제 (Examples)

계정의 모든 외부 소비자를 나열해요:

SHOW EXTERNAL CONSUMERS;

이름이 acme로 시작하는 외부 소비자를 나열해요:

SHOW EXTERNAL CONSUMERS LIKE 'acme%';

더 알아보기 (Learn more)