CREATE SCHEDULER RULE

Syntax

CREATE [OR REPLACE] SCHEDULER RULE <rule_name> [INCLUDING ADMIN] AS <rule>

[IF <condition> [<condition> ... ] THEN] {LIMIT <max_plans> [PER USER] | <action>}

RESOURCEGROUP {IS [NOT] <rsg_name> | [NOT] IN (<rsg_name>, ...)} |  
PRIORITY {IS [NOT] <priority> | [NOT] IN (<priority>, ...)} |
TYPE {IS [NOT] <plan_type> | [NOT] IN (<plan_type>, ...)} |  
DATABASE {IS [NOT] <db_name> | [NOT] IN (<db_name>, ...)} |  
USER {IS [NOT] <user_name> | [NOT] IN (<user_name>, ...)} |  
TABLE {IS [NOT] <table> | [NOT] IN (<table>, ...)} |  
TAG {IS [NOT] <tag_value> | [NOT] IN (<tag_value>)} |  
CLIENT_USER_ID {IS [NOT] '<string>' | [NOT] IN (<string>, ...)} |  
CLIENT_APPLICATION_NAME {IS [NOT] '<string>' | [NOT] IN (<string>, ...)} |
CLIENT_WORKSTATION_NAME {IS [NOT] '<string>' | [NOT] IN (<string>, ...)} |
CLIENT_ACCOUNTING_STRING {IS [NOT] '<string>' | [NOT] IN (<string>, ...)} |
ESTIMATE { < | <= | >= | > } <seconds>

LIMIT <max_plans> [PER USER]
SET [NOT] SHORT | 
SET ESTIMATE <seconds> | 
ADD TAG <tag_value> | 
SET PRIORITY {LOW | NORMAL | HIGH | CRITICAL} |
{INCREASE | DECREASE} PRIORITY |  
EXECUTE AS RESOURCEGROUP <rsg_name> |
ABORT '<message_for_client>' 

Eingaben

LIMIT 2 PER USER

IF USER IS <username> THEN LIMIT 2

Ausgaben

Berechtigungen

Sie müssen der Benutzer mit Administratorberechtigung sein oder Sie müssen über die Berechtigung für Schedulerregeln verfügen.

Verwendung

Es folgen Verwendungsbeispiele:

• Eine Schedulerregel mit dem Namen cube_builder_1 erstellen, die jeweils nur die Ausführung eines einzigen Plans aus einer Sitzung mit dem cube-Tag zulässt:

  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE cube_builder_1 AS IF TAG IS cube THEN LIMIT 1;

• Eine Schedulerregel mit dem Namen r23_eom1 erstellen, die die Priorität eines beliebigen Plans verringert, der seinen Ursprung in einer Sitzung mit dem eom-Tag hat:

  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE r23_eom1 AS IF TAG IS eom THEN DECREASE PRIORITY;

• Eine Schedulerregel mit dem Namen r23_up1 erstellen, die die Priorität eines beliebigen Plans erhöht, für den eine Kostenschätzung zwischen 5 und 12 Sekunden vorliegt:

  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE r23_up1 AS
    IF ESTIMATE >= 5 ESTIMATE < 12 THEN INCREASE PRIORITY;

• Die folgenden Befehle erstellen Schedulerregeln, die sicherstellen, dass die Anzahl Pläne, die Datenbankstatistik generieren oder aktualisieren, begrenzt ist, aber dass solche Pläne schnell ausgeführt werden:

  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE genstats_limit AS
    IF TYPE IS GENERATE STATISTICS THEN LIMIT 2;
  
  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE genstats_prio AS
    IF TYPE IS GENERATE STATISTICS THEN INCREASE PRIORITY;

• Die folgenden Befehle erstellen Schedulerregeln, die den Inhalt verschiedener Clientinformationsfelder verwenden, um die Prioritäten der Pläne festzulegen, die zu Sitzungen gehören:

  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE a1_default_prio_report AS
    IF CLIENT_APPLICATION_NAME IS Cognos THEN SET PRIORITY NORMAL;
  
  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE a2_top_prio_report AS
    IF CLIENT_ACCOUNTING_STRING IS CEO_report THEN SET PRIORITY CRITICAL;
  
  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE a3_high_prio_report AS
    IF CLIENT_ACCOUNTING_STRING IN ('weekly_report', 'daily_report') 
    THEN SET PRIORITY HIGH;
  
  MYDB.MYSCH(USER)=>
    CREATE SCHEDULER RULE a4_low_prio_user AS
    IF CLIENT_USER_ID IS sikspak THEN SET PRIORITY LOW;