DROP EXTERNAL AGENT

Remove o agente externo especificado do esquema atual ou especificado.

Nota

O descarte de um agente externo remove o aplicativo e os metadados de avaliação associados ao agente externo. Os rastreamentos e os resultados da avaliação que foram armazenados na tabela de eventos não são excluídos e permanecem armazenados. Para obter mais informações, consulte Dados de observabilidade.

Consulte também:

CREATE EXTERNAL AGENT, ALTER EXTERNAL AGENT, SHOW EXTERNAL AGENTS, DESCRIBE EXTERNAL AGENT

Sintaxe

DROP EXTERNAL AGENT [ IF EXISTS ] <name>

Parâmetros

name

Especifica o identificador do agente externo a ser descartado.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

Se o identificador do agente externo não for totalmente qualificado (no formato db_name.schema_name.external_agent_name ou schema_name.external_agent_name), o comando procurará o agente externo no esquema atual para a sessão.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

Notas

OWNERSHIP

Agent externo

OWNERSHIP é um privilégio especial para um objeto que é automaticamente concedido à função que criou o objeto, mas também pode ser transferido usando o comando GRANTOWNERSHIP para uma função diferente pela função proprietária (ou qualquer função com o privilégio MANAGE GRANTS).

Operar em um objeto em um esquema requer pelo menos um privilégio no banco de dados pai e pelo menos um privilégio no esquema pai.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • Quando a cláusula IF EXISTS é especificada e o objeto de destino não existe, o comando é concluído com sucesso sem retornar um erro.

  • Todas as versões associadas ao agente externo são descartadas junto com o agente externo.

  • Descartar um agente externo remove os metadados (como os nomes do aplicativo, da versão e da execução) associados ao agente externo. Os rastreamentos e os registros da avaliação gerados como parte das execuções não são excluídos e permanecem armazenados na tabela de eventos SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS.

  • Os objetos External Agent compartilham um namespace com os objetos do modelo. Garanta que esteja descartando o objeto correto.

Exemplos

Descartar um agente externo do esquema atual:

DROP EXTERNAL AGENT my_rag_app;

Descartar um agente externo de um banco de dados e esquema específicos:

DROP EXTERNAL AGENT mydb.myschema.my_rag_app;

Descartar um agente externo somente se ele existir:

DROP EXTERNAL AGENT IF EXISTS my_rag_app;