DROP EXTERNAL CONSUMER
DROP EXTERNAL CONSUMER
계정에서 외부 소비자(External Consumer)를 제거하는 명령어입니다. 외부 소비자를 삭제하면 그 소비자와 공유된 모든 리스팅(listing)에 대한 액세스가 즉시 취소됩니다.
출처: 문서
본문
DROP EXTERNAL CONSUMER는 계정에서 외부 소비자를 제거합니다. 외부 소비자를 삭제하면 그 소비자와 공유된 모든 리스팅에 대한 액세스가 즉시 취소됩니다. 관련 명령어로 CREATE EXTERNAL CONSUMER, ALTER EXTERNAL CONSUMER, SHOW EXTERNAL CONSUMERS, DESCRIBE EXTERNAL CONSUMER가 있어요.
구문 (Syntax)
DROP EXTERNAL CONSUMER [ IF EXISTS ] <name>
파라미터 (Parameters)
- IF EXISTS — 지정한 이름의 외부 소비자가 있을 때만 삭제합니다. 해당 이름의 외부 소비자가 없으면 오류를 반환하는 대신 아무것도 하지 않고 성공적으로 완료됩니다.
- name — 삭제할 외부 소비자의 식별자를 지정합니다.
접근 제어 요구 사항 (Access control requirements)
이 작업을 실행하는 역할은 최소한 OWNERSHIP 권한(객체: External Consumer)이 있어야 합니다. 외부 소비자를 삭제하는 데 필요합니다.
지정된 권한 집합으로 커스텀 역할을 만드는 방법은 Creating custom roles을, securable 객체에 대한 역할과 권한 부여에 관한 일반 정보는 Overview of Access Control을 참고하세요.
사용 참고 사항 (Usage notes)
- 외부 소비자를 삭제하면 그 소비자와 공유된 모든 리스팅에 대한 액세스가 취소됩니다. 리스팅 자체는 영향을 받지 않습니다.
- 외부 소비자와 연결된 모든 프로그래매틱 액세스 토큰은 소비자가 삭제될 때 무효화됩니다.
- 삭제된 외부 소비자는 복구할 수 없습니다.
IF EXISTS절을 지정하고 대상 객체가 존재하지 않으면, 명령어는 오류를 반환하지 않고 성공적으로 완료됩니다.
예제 (Examples)
외부 소비자를 삭제합니다.
DROP EXTERNAL CONSUMER acme_consumer;
존재할 때만 외부 소비자를 삭제합니다.
DROP EXTERNAL CONSUMER IF EXISTS acme_consumer;