DROP AGENT

현재 또는 지정된 데이터베이스 및 스키마에서 지정된 이름을 가진 지정된 :doc:`Cortex Agent</user-guide/snowflake-cortex/cortex-agents>`를 제거합니다.

참고 항목:

CREATE AGENT, DESCRIBE AGENT, SHOW AGENTS

구문

DROP AGENT [ IF EXISTS ] <name>
Copy

매개 변수

name

삭제할 Cortex Agent의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

액세스 제어 요구 사항

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

OWNERSHIP

에이전트

MODIFY

에이전트

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

  • IF EXISTS 절이 지정되고 대상 오브젝트가 존재하지 않는 경우 이 명령은 오류를 반환하지 않고 성공적으로 완료됩니다.

다음 예에서는 현재 스키마에서 이름이 ``my_agent``인 에이전트를 삭제합니다.

DROP AGENT my_agent;
Copy

다음 예에서는 mydb 데이터베이스 및 myschema 스키마에서 이름이 ``my_agent``인 에이전트를 삭제합니다. 에이전트가 존재하지 않으면 이 명령은 실패합니다.

DROP AGENT mydb.myschema.my_agent;
Copy

다음 예에서는 mydb 데이터베이스 및 myschema 스키마에서 이름이 ``my_agent``인 에이전트(있는 경우에만)를 삭제합니다.

DROP AGENT IF EXISTS mydb.myschema.my_agent;
Copy