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

Apache Doris 中文参考:SET PROPERTY

· 52CE 我爱测

## 描述 语句用于设置用户属性,包括分配给用户的资源和导入集群设置。 **相关命令** - CREATE USER - SHOW PROPERTY ## 语法 ## 必选参数 **1. ** 要设置的属性键。可用的键包括: - :最大连接数。 - :用户同一时间点执行查询可以使用的 instance 个数。 - :设置 SQL 阻止规则。设置后,该用户发送的查询如果匹配规则,则会被拒绝。 - :限制查询的 CPU 资源。详见会话变量

描述

SET PROPERTY 语句用于设置用户属性,包括分配给用户的资源和导入集群设置。

相关命令

语法

SET PROPERTY [ FOR '<user_name>' ] '<key_1>' = '<value_1>' [, '<key_2>' = '<value_2>', ...];

必选参数

1. <key_n>

要设置的属性键。可用的键包括:

  • max_user_connections:最大连接数。
  • max_query_instances:用户同一时间点执行查询可以使用的 instance 个数。
  • sql_block_rules:设置 SQL 阻止规则。设置后,该用户发送的查询如果匹配规则,则会被拒绝。
  • cpu_resource_limit:限制查询的 CPU 资源。详见会话变量 cpu_resource_limit 的介绍。-1 表示未设置。
  • exec_mem_limit:限制查询的内存使用。详见会话变量 exec_mem_limit 的介绍。-1 表示未设置。
  • resource_tags:指定用户的资源标签权限。
  • query_timeout:指定用户的查询超时。
  • default_workload_group:指定用户的默认工作负载组。
  • default_compute_group:指定用户的默认计算组。

注:如果未设置 cpu_resource_limit 和 exec_mem_limit,则默认使用会话变量中的值。

2. <value_n>

为指定键设置的值。

可选参数

1. <user_name>

要设置属性的用户名。如果省略,则为当前用户设置属性。

权限控制

执行此 SQL 命令的用户必须至少具有以下权限:

权限(Privilege) 对象(Object) 说明(Notes)
ADMIN_PRIV 用户(User)或 角色(Role) 用户或者角色拥有 ADMIN_PRIV 权限才能进行 SET PROPERTY 操作

注意事项

  • 用户属性是针对用户的,而不是针对 user_identity。例如,如果通过 CREATE USER 语句创建了两个用户 'jack'@'%' 和 'jack'@'192.%',则使用 SET PROPERTY 语句只能针对用户 'jack',而不是 'jack'@'%' 或 'jack'@'192.%'。

示例

  • 设置用户 'jack' 的最大连接数为 1000:

    SET PROPERTY FOR 'jack' 'max_user_connections' = '1000';
    
  • 设置用户 'jack' 的最大查询实例数为 3000:

    SET PROPERTY FOR 'jack' 'max_query_instances' = '3000';
    
  • 为用户 'jack' 设置 SQL 阻止规则:

    SET PROPERTY FOR 'jack' 'sql_block_rules' = 'rule1, rule2';
    
  • 设置用户 'jack' 的 CPU 资源限制:

    SET PROPERTY FOR 'jack' 'cpu_resource_limit' = '2';
    
  • 设置用户 'jack' 的资源标签权限:

    SET PROPERTY FOR 'jack' 'resource_tags.location' = 'group_a, group_b';
    
  • 设置用户 'jack' 的内存使用限制(以字节为单位):

    SET PROPERTY FOR 'jack' 'exec_mem_limit' = '2147483648';
    
  • 设置用户 'jack' 的查询超时时间(以秒为单位):

    SET PROPERTY FOR 'jack' 'query_timeout' = '500';
    
  • 设置用户 'jack' 的默认工作负载组:

    SET PROPERTY FOR 'jack' 'default_workload_group' = 'group1';
    
  • 设置用户 'jack' 的默认计算组:

    SET PROPERTY FOR 'jack' 'default_compute_group' = 'compute_group1';
    

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

资料来源与适用范围

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

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

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