DROP EXTERNAL AGENT
DROP EXTERNAL AGENT
현재 또는 지정된 스키마에서 지정한 외부 에이전트(External Agent)를 제거하는 명령어입니다.
참고: 외부 에이전트를 삭제하면 외부 에이전트와 연결된 애플리케이션 및 평가 메타데이터가 제거됩니다. 이벤트 테이블에 저장된 트레이스와 평가 결과는 삭제되지 않고 그대로 유지됩니다. 자세한 내용은 AI_OBSERVABILITY_EVENTS 테이블을 참고하세요.
출처: 문서
본문
DROP EXTERNAL AGENT는 현재 또는 지정된 스키마에서 지정한 외부 에이전트를 제거합니다. 관련 명령어로 CREATE EXTERNAL AGENT, ALTER EXTERNAL AGENT, SHOW EXTERNAL AGENTS, DESCRIBE EXTERNAL AGENT가 있어요.
구문 (Syntax)
DROP EXTERNAL AGENT [ IF EXISTS ] <name>
파라미터 (Parameters)
- name — 삭제할 외부 에이전트의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements를 참고하세요. 외부 에이전트 식별자가 정규화되지 않았다면(db_name.schema_name.external_agent_name 또는 schema_name.external_agent_name 형태), 명령어는 세션의 현재 스키마에서 외부 에이전트를 찾습니다.
접근 제어 요구 사항 (Access control requirements)
이 작업을 실행하는 역할은 최소한 OWNERSHIP 권한(객체: External Agent)이 있어야 합니다. OWNERSHIP은 객체에 대한 특별한 권한으로, 객체를 생성한 역할에 자동으로 부여되지만 소유 역할(또는 MANAGE GRANTS 권한이 있는 역할)이 GRANT OWNERSHIP으로 이전할 수 있습니다.
스키마 안의 객체를 조작하려면 상위 데이터베이스에 대한 권한이 1개 이상, 상위 스키마에 대한 권한이 1개 이상 필요합니다. 지정된 권한 집합으로 커스텀 역할을 만드는 방법은 Creating custom roles을, securable 객체에 대한 역할과 권한 부여에 관한 일반 정보는 Overview of Access Control을 참고하세요.
사용 참고 사항 (Usage notes)
IF EXISTS절을 지정하고 대상 객체가 존재하지 않으면, 명령어는 오류를 반환하지 않고 성공적으로 완료됩니다.- 외부 에이전트와 연결된 모든 버전은 외부 에이전트와 함께 삭제됩니다.
- 외부 에이전트를 삭제하면 외부 에이전트와 연결된 메타데이터(애플리케이션 이름, 버전 이름, 실행 이름 등)가 제거됩니다. 실행의 일부로 생성된 트레이스와 평가 기록은 삭제되지 않고
SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS이벤트 테이블에 그대로 유지됩니다. - 외부 에이전트 객체는 모델 객체와 네임스페이스를 공유합니다. 올바른 객체를 삭제하고 있는지 확인하세요.
예제 (Examples)
현재 스키마에서 외부 에이전트를 삭제합니다.
DROP EXTERNAL AGENT my_rag_app;
특정 데이터베이스와 스키마에서 외부 에이전트를 삭제합니다.
DROP EXTERNAL AGENT mydb.myschema.my_rag_app;
존재할 때만 외부 에이전트를 삭제합니다.
DROP EXTERNAL AGENT IF EXISTS my_rag_app;