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 :

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.

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;