SET-PROPERTY
Description
Set user attributes, including resources assigned to users, importing clusters, compute groups etc.
Syntax
SET PROPERTY [FOR 'user'] 'key' = 'value' [, 'key' = 'value']
The user attribute set here is for user, not user_identity. That is, if two users 'jack'@'%' and 'jack'@'192.%' are created through the CREATE USER statement, the SET PROPERTY statement can only be used for the user jack, not 'jack'@'% ' or 'jack'@'192.%'
Parameters
user
The username for which to set attributes. If omitted, the attributes are set for the current user.
key
The attribute key to set. Available keys include:
max_user_connections
: The maximum number of connections.max_query_instances
: The number of instances that a user can use to execute a query at the same time.sql_block_rules
: Set SQL block rules. Once set, queries sent by this user will be rejected if they match the rules.cpu_resource_limit
: Limit the CPU resources for queries. See the introduction to the session variablecpu_resource_limit
for details. -1 means not set.exec_mem_limit
: Limit the memory usage of the query. See the introduction to the session variableexec_mem_limit
for details. -1 means not set.resource_tags
: Specifies the user's resource tag permissions.query_timeout
: Specifies the user's query timeout.default_workload_group
: Specifies the user's default workload group.default_compute_group
: Specifies the user's default compute group.
Note: If the attributes cpu_resource_limit
and exec_mem_limit
are not set, the value in the session variable will be used by default.
value
The value to set for the specified key.
Example
Modify the maximum number of user jack connections to 1000
SET PROPERTY FOR 'jack' 'max_user_connections' = '1000';
Modify the number of available instances for user jack's query to 3000
SET PROPERTY FOR 'jack' 'max_query_instances' = '3000';
Modify the sql block rule of user jack
SET PROPERTY FOR 'jack' 'sql_block_rules' = 'rule1, rule2';
Modify the cpu usage limit of user jack
SET PROPERTY FOR 'jack' 'cpu_resource_limit' = '2';
Modify the user's resource tag permissions
SET PROPERTY FOR 'jack' 'resource_tags.location' = 'group_a, group_b';
Modify the user's query memory usage limit, in bytes
SET PROPERTY FOR 'jack' 'exec_mem_limit' = '2147483648';
Modify the user's query timeout limit, in second
SET PROPERTY FOR 'jack' 'query_timeout' = '500';
Set the default workload group for user 'jack':
SET PROPERTY FOR 'jack' 'default_workload_group' = 'group1';
Set the default compute group for user 'jack':
SET PROPERTY FOR 'jack' 'default_compute_group' = 'compute_group1';
Related Commands
Keywords
SET, PROPERTY, COMPUTE GROUP, WORKLOAD GROUP