大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:CREATE WORKLOAD POLICY

· 52CE 我爱测

2. - be_scan_rows,一个 SQL 在单个 BE 进程内 Scan 的行数,如果这个 SQL 在 BE 上是多并发执行,那么就是多个并发的累加值。 - be_scan_bytes,一个 SQL 在单个 BE 进程内 Scan 的字节数,如果这个 SQL 在 BE 上是多并发执行,那么就是多个并发的累加值,单位是字节。 - query_time,一个 SQL 在单个 BE 进程上的运行时间,时间单位是毫秒。 - query_be_memory_bytes,从 2.1.5 版本开始支持。一个 SQL 在单个 BE 进程内使用的内存用量,如果这个 SQL 在 BE 上是多并发执行,那么就是多个并发的累加值,单位是字节。

描述

创建一个 Workload Policy,用于当一个查询满足一些条件时,就对该查询执行相应的动作。

语法

CREATE WORKLOAD POLICY [ IF NOT EXISTS ] <workload_policy_name>
CONDITIONS(<conditions>) ACTIONS(<actions>)
[ PROPERTIES (<properties>) ]

必选参数

  1. <workload_policy_name>: Workload Policy 的名字

  2. <conditions>

    • be_scan_rows,一个 SQL 在单个 BE 进程内 Scan 的行数,如果这个 SQL 在 BE 上是多并发执行,那么就是多个并发的累加值。
    • be_scan_bytes,一个 SQL 在单个 BE 进程内 Scan 的字节数,如果这个 SQL 在 BE 上是多并发执行,那么就是多个并发的累加值,单位是字节。
    • query_time,一个 SQL 在单个 BE 进程上的运行时间,时间单位是毫秒。
    • query_be_memory_bytes,从 2.1.5 版本开始支持。一个 SQL 在单个 BE 进程内使用的内存用量,如果这个 SQL 在 BE 上是多并发执行,那么就是多个并发的累加值,单位是字节。
  3. <actions>

    • cancel_query,取消查询。

可选参数

  1. <properties>
    • enabled,取值为 true 或 false,默认值为 true,表示当前 Policy 处于启用状态,false 表示当前 Policy 处于禁用状态。

    • priority,取值范围为 0 到 100 的正整数,默认值为 0,代表 Policy 的优先级,该值越大,优先级越高。这个属性的主要作用是,当匹配到多个 Policy 时,选择优先级最高的 Policy。

    • workload_group,目前一个 Policy 可以绑定一个 Workload Group,代表这个 Policy 只对某个 Workload Group 生效。默认为空,代表对所有查询生效。

      由于 Workload Group 自身归属于 Compute Group,因此该属性的取值需要按以下规则书写:

      • 存算分离模式(Cloud 模式):必须使用完整的 <compute_group>.<workload_group> 形式,例如 'workload_group'='compute_group_a.wg1'。如果使用裸的 <workload_group> 形式、出现多于一个的 .、或前后存在空段(如 .wg1、wg1.),都会被拒绝并抛出 workload_group must be '<compute_group>.<workload_group>' in cloud mode 错误。

      • 存算一体模式(非 Cloud 模式):支持以下两种形式:

        • <workload_group>:默认绑定到默认 Resource Group(default)下的同名 Workload Group。
        • <resource_group>.<workload_group>:显式指定 Resource Group。此处的前缀实际指代 Resource Group(Tag),与存算分离模式共用语法只是为了形式统一。

        同样不允许多于一个的 . 或空段,违反将抛出 workload_group must be '<workload_group>' or '<resource_group>.<workload_group>' in non-cloud mode 错误。

权限控制

至少具备ADMIN_PRIV权限

示例

  1. 新建一个 Workload Policy,作用是杀死所有查询时间超过 3s 的查询

    create workload policy kill_big_query conditions(query_time > 3000) actions(cancel_query)
    
  2. 新建一个 Workload Policy,默认不开启

    create workload policy kill_big_query conditions(query_time > 3000) actions(cancel_query) properties('enabled'='false')
    
  3. 新建一个只对存算分离模式下 compute_group_a 中的 Workload Group wg1 生效的 Policy(注意完整限定形式)

    create workload policy kill_big_query conditions(query_time > 3000) actions(cancel_query) properties('workload_group'='compute_group_a.wg1')
    

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。