AnalyticDB:ワークロード管理ルールの設定

構文

wlm add_rule
name=<ruleName>
type=query      
action=<ruleAtion>    
predicate='<property><operator><value> && <property><operator><value>'
[attrs='<ruleAttrs>']
[resource_group=<ruleResource_group>]
[description='<ruleDescription>']
[compatible_group=<compatible_group_name>]
[enabled=<ruleEnabled>]
[priority=<rulePriority>]

パラメーター

例

• 例1: testRule1という名前のルールを作成します。 ユーザー名がtestで、SQLパターンの履歴実行期間の50パーセンタイルが60,000 msより長い場合、クエリは終了します。

  wlm add_rule 
  name=testRule1
  type=query 
  action=kill 
  predicate='user=test && PATTERN_RT_P50>60000';

  サンプル結果:

  +---------------------------------+
  | result                          |
  +---------------------------------+
  | insert rule 'testRule1' success |
  +---------------------------------+

• 例2: testRule2という名前のルールを作成します。 ユーザー名がtestで、ユーザーIPアドレスが10.10.10.10、192.168.0.1、または192.0.2.1の場合、query_priority=lowヒントがクエリに追加されます。

  wlm add_rule 
  name=testRule2 
  type=query 
  action=ADD_PROPERTIES 
  attrs='{"add_prop":{"query_priority":"low"}}' 
  predicate='user=test && source_ip in 10.10.10.10,192.168.0.1,192.0.2.1';

  サンプル結果:

  +---------------------------------+
  | result                          |
  +---------------------------------+
  | insert rule 'testRule2' success |
  +---------------------------------+

• 例3: testResourceGroupリソースグループの優先度が5であるtestRule3という名前のルールを作成します。 ユーザー名がtestで、クエリの種類がSELECTの場合、クエリは終了します。

  wlm add_rule
  name=testRule3
  type=query
  resource_group=testResourceGroup
  description='just a test'
  priority=5
  action=kill
  predicate='user=test && query_task_type=1';

  サンプル結果:

  +---------------------------------+
  | result                          |
  +---------------------------------+
  | insert rule 'testRule3' success |
  +---------------------------------+

構文

wlm update_rule
id=<ruleId>
name=<ruleName>
type=query 
action=<ruleAtion> 
predicate='<property><operator><value> && <property><operator><value>'
[attrs='<ruleAttrs>']
[resource_group=<ruleResource_group>]
[description='<ruleDescription>']
[compatible_group=<compatible_group_name>]
[enabled=<ruleEnabled>]
[priority=<rulePriority>]

Parameters

例

• 例1: IDが2のルールの名前をruleに変更します。

  wlm update_rule 
  id=2
  name=Rule;

  サンプル結果:

  +-----------------+
  | result          |
  +-----------------+
  | update rule 2   |
  +-----------------+

• 例2: testRule1ルールの条件を変更します。 ユーザー名がtestで、SQLパターンの履歴実行期間の50パーセンタイルが80,000 msより長い場合、クエリは終了します。

  wlm update_rule
  name=testRule1
  predicate='user=test && PATTERN_RT_P50>80000';

  または、対応するルールIDを使用してtestRule1ルールを変更します。

  wlm update_rule 
  id=1
  predicate='user=test && PATTERN_RT_P50>80000';

  サンプル結果:

  +-----------------+
  | result          |
  +-----------------+
  | update rule 1   |
  +-----------------+

• 例3: testRule1ルールの要件を満たすすべてのクエリをtestgroupリソースグループに再送信して実行します。

  アクションがKILLに設定されているtestRule1という名前のルールを作成します。

  wlm add_rule 
  name=testRule1
  type=query 
  action=kill 
  predicate='user=test && PATTERN_RT_P50>60000';

  testRule1ルールを変更して、現在のリソースグループからtestgroupリソースグループにクエリを再送信して実行します。

  wlm update_rule
  name=testRule1
  action=RESUBMIT_RESOURCE_GROUP
  attrs='{
      "resubmit":{
      "resource_group": "testgroup"
      }
  }'

  説明

  attrsパラメーターの指定方法については、このトピックの「付録3: 操作」を参照してください。

  サンプル結果:

  +-----------------+
  | result          |
  +-----------------+
  | update rule 1   |
  +-----------------+

構文

wlm list_rule
[id=<ruleID>]
[name='<ruleName>'\G]

パラメーター

例

• 例1: IDがtestID1であるルールに関する情報を照会します。

  wlm list_rule 
  id=1 \G;

  サンプル結果:

              id: 1
              name: testRule4
       description: NULL
              type: QUERY
    resource_group: user_default
           enabled: 1
          priority: 0
           version: 1
        life_cycle: BEFORE_QUEUEING
  compatible_group:
       valid_begin: null
         valid_end: null
           creator: kepler
       update_user: kepler
       create_time: 2022-09-16 14:00:18
       update_time: 2022-09-16 14:00:18
         predicate: [{"property":"${session.user}","value":"test","operator":"equal"},{"property":"${session.source_ip}","value":"1,2,3","operator":"in"}]
            action: ADD_PROPERTIES
             attrs: {"add_prop":{"query_priority":"low"}}
  1 row in set (0.11 sec)

• 例2: IDがtestID1で名前がtestRule4であるルールに関する情報を照会します。

  mysql> wlm list_rule 
  id=1 
  name='testRule4' \G;

  サンプル結果:

              id: 1
              name: testRule4
       description: NULL
              type: QUERY
    resource_group: user_default
           enabled: 1
          priority: 0
           version: 1
        life_cycle: BEFORE_QUEUEING
  compatible_group:
       valid_begin: null
         valid_end: null
           creator: kepler
       update_user: kepler
       create_time: 2022-09-16 14:00:18
       update_time: 2022-09-16 14:00:18
         predicate: [{"property":"${session.user}","value":"test","operator":"equal"},{"property":"${session.source_ip}","value":"1,2,3","operator":"in"}]
            action: ADD_PROPERTIES
             attrs: {"add_prop":{"query_priority":"low"}}
  1 row in set (0.09 sec)

構文

wlm disable_rule id=<ruleID>

パラメーター

例

• 例1: IDがtestID1のルールを無効にします。

  wlm disable_rule id=1;

  サンプル結果:

  +------------------+
  | result           |
  +------------------+
  | disable rule 1   |
  +------------------+

• 例2: IDがtestID1であるルールに関する情報を照会します。

  wlm list_rule id=1\G;

  サンプル結果:

              id: 1
              name: testRule4
       description: NULL
              type: QUERY
    resource_group: user_default
           enabled: 0
          priority: 0
           version: 1
        life_cycle: BEFORE_QUEUEING
  compatible_group:
       valid_begin: null
         valid_end: null
           creator: kepler
       update_user: kepler
       create_time: 2022-09-16 14:00:18
       update_time: 2022-09-16 14:00:18
         predicate: [{"property":"${session.user}","value":"test","operator":"equal"},{"property":"${session.source_ip}","value":"1,2,3","operator":"in"}]
            action: ADD_PROPERTIES
             attrs: {"add_prop":{"query_priority":"low"}}

構文

wlm enable_rule id=<ruleID>

パラメーター

例

• 例1: IDがtestID1のルールを有効にします。

  wlm enable_rule id=1;

  サンプル結果:

  +----------------+
  | result         |
  +----------------+
  | enable rule 1  |
  +----------------+

• 例2: IDがtestID1であるルールに関する情報を照会します。

  wlm list_rule id=1\G;

  サンプル結果:

              id: 1
              name: testRule4
       description: NULL
              type: QUERY
    resource_group: user_default
           enabled: 1
          priority: 0
           version: 1
        life_cycle: BEFORE_QUEUEING
  compatible_group:
       valid_begin: null
         valid_end: null
           creator: kepler
       update_user: kepler
       create_time: 2022-09-16 14:00:18
       update_time: 2022-09-16 14:00:18
         predicate: [{"property":"${session.user}","value":"test","operator":"equal"},{"property":"${session.source_ip}","value":"1,2,3","operator":"in"}]
            action: ADD_PROPERTIES
             attrs: {"add_prop":{"query_priority":"low"}}

構文

wlm delete_rule id=<ruleID>

パラメーター

例

• 例1: IDがtestID1のルールを削除します。

  wlm delete_rule id=1;

  サンプル結果:

  +----------------+
  | result         |
  +----------------+
  | delete rule 1  |
  +----------------+

• 例2: IDがtestID1であるルールに関する情報を照会します。

  wlm list_rule id=1\G;

  サンプル結果:

  Empty set

構文

wlm calc_pattern_hash <SQL>

パラメーター

例

クエリのパターンハッシュ値を取得します。

wlm calc_pattern_hash select * from t where a=1 and b=2;

サンプル結果:

+-----------------------------------+----------------------+
| raw_sql                           | pattern_hash         |
+-----------------------------------+----------------------+
| select * from t where a=1 and b=2 | -4759960226441980963 |
+-----------------------------------+----------------------+

付録1: プロパティ

付録2: 演算子

付録3: アクション