DROP AGENT¶

语法¶

DROP AGENT [ IF EXISTS ] <name>

参数¶

name

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

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

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

访问控制要求¶

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

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.

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

有关对 安全对象 执行 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;