DROP AGENT¶

语法¶

DROP AGENT [ IF EXISTS ] <name>

参数¶

name

指定要删除的 Cortex Agent 的标识符。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

访问控制要求¶

用于执行此操作的 角色 必须至少具有以下 权限：

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需 同时 被授予该架构的 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明¶

• 如果指定了 IF EXISTS 子句，而目标对象不存在，该命令会成功完成，不会返回错误。

示例¶

以下示例删除了当前架构中名为 my_agent 的代理：

DROP AGENT my_agent;

以下示例删除了在 mydb 数据库和 myschema 架构中名为 my_agent 的代理。如果代理不存在，则此命令将失败：

DROP AGENT mydb.myschema.my_agent;

以下示例仅在 mydb 数据库和 myschema 架构中存在名为 my_agent 的代理时才删除该代理：

DROP AGENT IF EXISTS mydb.myschema.my_agent;