类别:

系统函数 (系统控制)

SYSTEM$CANCEL_QUERY

如果指定的查询(或语句)当前处于活跃/运行状态,则取消该查询(或语句)。

另请参阅:

SYSTEM$CANCEL_ALL_QUERIES

语法

SYSTEM$CANCEL_QUERY( <query_id> )
Copy

实参

query_id

要取消的查询的标识符。要获取过去 14 天内执行的查询的 ID,请登录 Web 界面,然后转到 History History 选项卡 页面。

使用说明

  • 用户可以使用此 SQL 函数取消自己正在运行的 SQL 操作。取消由其他用户执行的正在运行的操作需要具有以下权限 之一 的角色:

    • 执行操作用户的 OWNERSHIP。

    • 运行操作的仓库的 OPERATE 或 OWNERSHIP(如果适用)。

    请注意,ACCOUNTADMIN 角色不一定被授予任何这些权限。

  • Snowflake 查询 IDs 是带有连字符的 UUID 文本字符串,连字符是特殊字符,因此必须使用单引号对字符串进行转义。

  • 此函数不用于取消对特定仓库或用户的查询。请改用:

示例

SELECT SYSTEM$CANCEL_QUERY('d5493e36-5e38-48c9-a47c-c476f2111ce5');

+-------------------------------------------------------------+
| SYSTEM$CANCEL_QUERY('D5493E36-5E38-48C9-A47C-C476F2111CE5') |
|-------------------------------------------------------------|
| query [d5493e36-5e38-48c9-a47c-c476f2111ce5] terminated.    |
+-------------------------------------------------------------+
Copy
语言: 中文