SET PROPERTY

説明

リソースの割り当て、クラスターのインポートなど、ユーザー属性を設定します。

関連コマンド

• CREATE USER
• SHOW PROPERTY

構文

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

必須パラメータ

1. <key_n>

スーパーユーザー権限:

• max_user_connections: 最大接続数。
• max_query_instances: ユーザーが同時にクエリを実行するために使用できるインスタンス数。
• 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コマンドを実行するユーザーは、少なくとも以下の権限を持っている必要があります:

権限	オブジェクト	注意事項
ADMIN_PRIV	User or Role	このSET PROPERTY操作は、ADMIN_PRIV権限を持つユーザーまたはロールによってのみ実行できます。

使用上の注意

• ここで設定されるユーザー属性は、user_identityではなく、userに対するものです。つまり、CREATE USER文を通じて'jack'@'%'と'jack'@'192.%'の2つのユーザーが作成された場合、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';

• ユーザーのリソースタグ権限を変更する

  SET PROPERTY FOR 'jack' 'resource_tags.location' = 'group_a, group_b';

• ユーザーのクエリメモリ使用量制限をバイト単位で変更する

  SET PROPERTY FOR 'jack' 'exec_mem_limit' = '2147483648';

• ユーザーのクエリタイムアウト制限を秒単位で変更する

  SET PROPERTY FOR 'jack' 'query_timeout' = '500';