DROP AGENT
DROP AGENT
현재 또는 지정된 데이터베이스와 스키마에서 지정한 이름의 Cortex Agent를 제거하는 명령어입니다.
출처: 문서
본문
DROP AGENT는 현재 또는 지정된 데이터베이스와 스키마에서 지정한 이름의 Cortex Agent를 제거합니다. 관련 명령어로 ALTER AGENT, CREATE AGENT, DESCRIBE AGENT, SHOW AGENTS, DATA_AGENT_RUN (SNOWFLAKE.CORTEX)가 있어요.
구문 (Syntax)
DROP AGENT [ IF EXISTS ] <name>
파라미터 (Parameters)
- name — 삭제할 Cortex Agent의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements를 참고하세요.
접근 제어 요구 사항 (Access control requirements)
이 SQL 명령어를 실행하는 역할은 최소한 다음 권한 중 하나가 있어야 합니다: OWNERSHIP 또는 MODIFY (객체: Agent).
스키마 안의 객체를 조작하려면 상위 데이터베이스에 대한 권한이 1개 이상, 상위 스키마에 대한 권한이 1개 이상 필요합니다. 지정된 권한 집합으로 커스텀 역할을 만드는 방법은 Creating custom roles을, securable 객체에 대한 역할과 권한 부여에 관한 일반 정보는 Overview of Access Control을 참고하세요.
사용 참고 사항 (Usage notes)
IF EXISTS절을 지정하고 대상 객체가 존재하지 않으면, 명령어는 오류를 반환하지 않고 성공적으로 완료됩니다.
예제 (Examples)
다음은 현재 스키마에서 my_agent라는 에이전트를 삭제하는 예제입니다.
DROP AGENT my_agent;
다음은 mydb 데이터베이스와 myschema 스키마에서 my_agent라는 에이전트를 삭제하는 예제입니다. 이 명령어는 에이전트가 존재하지 않으면 실패합니다.
DROP AGENT mydb.myschema.my_agent;
다음은 mydb 데이터베이스와 myschema 스키마에서 my_agent라는 에이전트를 존재할 때만 삭제하는 예제입니다.
DROP AGENT IF EXISTS mydb.myschema.my_agent;