DROP EXTERNAL AGENT

Supprime l’Agent externe spécifié du schéma actuel ou spécifié.

Note

La suppression d’un agent externe supprime les métadonnées d’application et d’évaluation associées à l’agent externe. Les traces et les résultats d’évaluation qui étaient stockés dans le tableau des événements ne sont pas supprimés et restent stockés. Pour plus d’informations, voir Données d’observabilité.

Voir aussi :

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

Syntaxe

DROP EXTERNAL AGENT [ IF EXISTS ] <name>

Paramètres

name

Indique l’identificateur de la table externe à abandonner.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

Si l’identificateur de l’agent externe n’est pas complet (sous la forme db_name.schema_name.external_agent_name ou schema_name.external_agent_name), la commande recherche l’agent externe dans le schéma actuel de la session.

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège

Objet

Remarques

OWNERSHIP

Agent externe

OWNERSHIP est un privilège spécial sur un objet qui est automatiquement accordé au rôle qui a créé l’objet, mais qui peut aussi être transféré à l’aide de la commande GRANTOWNERSHIP à un rôle différent par le rôle propriétaire (ou par tout rôle avec le privilège MANAGEGRANTS).

Pour effectuer une opération sur un objet dans un schéma, il est nécessaire de disposer d’au moins un privilège sur la base de données parente et d’au moins un privilège sur le schéma parent.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation

  • Lorsque la clause IF EXISTS est spécifiée et que l’objet cible n’existe pas, la commande se termine correctement, sans renvoyer d’erreur.

  • Toutes les versions associées à l’agent externe sont abandonnées en même temps que l’agent externe.

  • L’abandon d’un agent externe supprime les métadonnées (telles que le nom de l’application, le nom de la version et le nom de l’exécution) associées à l’agent externe. Les traces et les enregistrements d’évaluation générés dans le cadre des exécutions ne sont pas supprimés et restent stockés dans le tableau des événements SNOWFLAKE .LOCAL .AI_OBSERVABILITY_EVENTS.

  • Les objets d’agent externes partagent un espace de noms avec des objets modèle. Assurez-vous que vous supprimez le bon objet.

Exemples

Supprimer un agent externe dans le schéma actuel :

DROP EXTERNAL AGENT my_rag_app;

Supprimer un agent externe dans une base de données et un schéma spécifiques :

DROP EXTERNAL AGENT mydb.myschema.my_rag_app;

Supprimer un agent externe uniquement s’il existe :

DROP EXTERNAL AGENT IF EXISTS my_rag_app;