DROP AGENT¶

Syntaxe¶

DROP AGENT [ IF EXISTS ] <name>

Paramètres¶

name

Spécifie l’identificateur de l’Agent Cortex à supprimer.

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.

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 :

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma. Notez qu’un rôle doté d’un privilège quelconque sur un schéma permet à ce rôle de résoudre le schéma. Par exemple, un rôle doté du privilège CREATE sur un schéma peut créer des objets sur ce schéma sans également avoir le privilège USAGE attribué sur ce schéma.

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.

Exemples¶

L’exemple suivant supprime l’agent nommé my_agent dans le schéma actuel :

DROP AGENT my_agent;

L’exemple suivant supprime l’agent nommé my_agent dans la base de données mydb et le schéma myschema. Cette commande échoue si l’agent n’existe pas :

DROP AGENT mydb.myschema.my_agent;

L’exemple suivant supprime l’agent nommé my_agent dans la base de données mydb et le schéma myschema uniquement s’il existe :

DROP AGENT IF EXISTS mydb.myschema.my_agent;