ALTER WORK ACTION SET ステートメント

ALTER WORK ACTION SET ステートメントは、作業アクション・セットの作業アクションを追加、変更、またはドロップすることによって、その作業アクション・セットに変更を加えます。

呼び出し

このステートメントは、アプリケーション・プログラムに組み込むか、あるいは対話式に発行することができます。これは、DYNAMICRULES の実行動作がパッケージに効力を持つ場合にのみ、動的に準備できる実行可能ステートメントです (SQLSTATE 42509)。

許可

ステートメントの許可 ID によって保持されている特権には、少なくとも以下のいずれかの権限が含まれていなければなりません。
  • SQLADM 権限 (すべての変更節が COLLECT 節の場合のみ)
  • WLMADM 権限
  • DBADM 権限

構文

構文図を読む構文図をスキップするALTER WORK ACTION SETwork-action-set-name 1ADDwork-action-definitionALTERwork-action-alterationDROPWORK ACTIONwork-action-name2ENABLEDISABLE
work-action-definition
構文図を読む構文図をスキップするWORK ACTIONwork-action-name ON WORK CLASSwork-class-name action-types-clause histogram-template-clauseENABLEDISABLE
action-types-clause
構文図を読む構文図をスキップするMAP ACTIVITYWITH NESTEDWITHOUT NESTEDTOservice-subclass-nameWHENthreshold-predicate-clausethreshold-exceeded-actionsPREVENT EXECUTIONCOUNT ACTIVITYCOLLECT ACTIVITY DATAcollect-activity-data-clauseCOLLECT AGGREGATE ACTIVITY DATABASEEXTENDED
threshold-predicate-clause
構文図を読む構文図をスキップする3CONCURRENTDBCOORDACTIVITIES>integerAND QUEUEDACTIVITIES>integerAND QUEUEDACTIVITIES UNBOUNDEDSQLTEMPSPACE>integerKMGSQLROWSRETURNED>integerESTIMATEDSQLCOST>bigintCPUTIME>integer-valueHOURHOURSMINUTEMINUTESCHECKING EVERYinteger-valueSECONDSECONDSSQLROWSREAD>bigint-valueCHECKING EVERYinteger-valueSECONDSECONDSACTIVITYTOTALTIME>integerDAYDAYSHOURHOURSMINUTEMINUTESSECONDS
threshold-exceeded-actions
構文図を読む構文図をスキップするCOLLECT ACTIVITY DATA NONECOLLECT ACTIVITY DATAcollect-activity-data-clauseSTOP EXECUTIONCONTINUE
collect-activity-data-clause
構文図を読む構文図をスキップするON COORDINATORMEMBERON ALLMEMBERSWITHOUT DETAILSWITH,DETAILS4SECTIONINCLUDE ACTUALS BASE5AND VALUES
histogram-template-clause
構文図を読む構文図をスキップする● ACTIVITY LIFETIME HISTOGRAM TEMPLATESYSDEFAULTHISTOGRAMACTIVITY LIFETIME HISTOGRAM TEMPLATEtemplate-name ● ACTIVITY QUEUETIME HISTOGRAM TEMPLATESYSDEFAULTHISTOGRAMACTIVITY QUEUETIME HISTOGRAM TEMPLATEtemplate-name ● ACTIVITY EXECUTETIME HISTOGRAM TEMPLATESYSDEFAULTHISTOGRAMACTIVITY EXECUTETIME HISTOGRAM TEMPLATEtemplate-name ● ACTIVITY ESTIMATEDCOST HISTOGRAM TEMPLATESYSDEFAULTHISTOGRAMACTIVITY ESTIMATEDCOST HISTOGRAM TEMPLATEtemplate-name ● ACTIVITY INTERARRIVALTIME HISTOGRAM TEMPLATESYSDEFAULTHISTOGRAMACTIVITY INTERARRIVALTIME HISTOGRAM TEMPLATEtemplate-name ●
work-action-alteration
構文図を読む構文図をスキップするWORK ACTIONwork-action-name 6SET WORK CLASSwork-class-namealter-action-types-clause●ACTIVITY LIFETIME HISTOGRAM TEMPLATEtemplate-name●●ACTIVITY QUEUETIME HISTOGRAM TEMPLATEtemplate-name●●ACTIVITY EXECUTETIME HISTOGRAM TEMPLATEtemplate-name●●ACTIVITY ESTIMATEDCOST HISTOGRAM TEMPLATEtemplate-name●●ACTIVITY INTERARRIVALTIME HISTOGRAM TEMPLATEtemplate-name●ENABLEDISABLE
alter-action-types-clause
構文図を読む構文図をスキップするMAP ACTIVITYWITH NESTEDWITHOUT NESTEDTOservice-subclass-nameWHENthreshold-predicate-clausePERFORM ACTIONalter-threshold-exceeded-actionsEXCEEDEDalter-threshold-exceeded-actionsPREVENT EXECUTIONCOUNT ACTIVITYCOLLECT ACTIVITY DATAalter-collect-activity-data-clauseCOLLECT AGGREGATE ACTIVITY DATABASEEXTENDED
alter-threshold-exceeded-actions
構文図を読む構文図をスキップする78COLLECT ACTIVITY DATAalter-collect-activity-data-clauseNONESTOP EXECUTIONCONTINUE
alter-collect-activity-data-clause
構文図を読む構文図をスキップするON COORDINATORMEMBERON ALLMEMBERSWITHOUT DETAILSWITH,DETAILS9SECTIONINCLUDE ACTUALS BASEAND VALUES
注:
  • 1 ADD、ALTER、および DROP 節は、指定されている順に処理されます。
  • 2 ENABLE または DISABLE 節は、1 つのステートメント内で一度だけ指定することができます。
  • 3 1 つの作業クラスに一度に適用できる同一しきい値タイプの作業アクションは、1 つだけです。 しきい値作業アクションを変更するときに、しきい値述部を変更することはできません。
  • 4 DETAILS は指定すべき最小限のキーワードで、そのあとにコンマで区切ってオプションを指定します。
  • 5 この節はしきい値には適用されません。
  • 6 同じ節を複数回指定することはできません。
  • 7 同じ節を複数回指定することはできません。
  • 8 既存の作業アクションにしきい値を超過した場合のアクションが定義されていない場合に、これをしきい値作業アクションになるように変更する際には、STOP EXECUTION または CONTINUE を指定しなければなりません。COLLECT ACTIVITY DATA を指定しないと、COLLECT ACTIVITY DATA NONE がデフォルトになります。
  • 9 DETAILS は指定すべき最小限のキーワードで、そのあとにコンマで区切ってオプションを指定します。

説明

work-action-set-name
変更する作業アクション・セットを識別します。これは、1 部構成の名前です。 これは、SQL ID です (通常 ID または区切り ID)。 work-action-set-name には、現行のサーバー上の既存の作業アクション・セットを指定する必要があります (SQLSTATE 42704)。
ADD
作業アクション・セットに作業アクションを追加します。
WORK ACTION work-action-name
作業アクションの名前を指定します。 work-action-name は、現行のサーバーのこの作業アクション・セットの下に既存の作業アクションを識別するものであってはなりません (SQLSTATE 42710)。 work-action-name の先頭に SYS を使用することはできません (SQLSTATE 42939)。
ON WORK CLASS work-class-name
この作業アクションが適用されるデータベース・アクティビティーを識別する作業クラスを指定します。 work-class-name は、現行のサーバーの work-class-set-name に存在するものでなければなりません (SQLSTATE 42704)。
MAP ACTIVITY
アクティビティーのマッピングの作業アクションを指定します。 このアクションは、この作業アクション・セットが定義されているオブジェクトがサービス・スーパークラスである場合にのみ指定できます (SQLSTATE 5U034)。
WITH NESTED または WITHOUT NESTED
このアクティビティーの下にネストされているアクティビティーをサービス・サブクラスにマップするかどうかを指定します。 デフォルトは WITH NESTED です。
WITH NESTED
作業クラスに分類されるすべてのデータベース・アクティビティーのうちネスティング・レベルがゼロのもの、およびこのアクティビティーの下でネストされているすべてのデータベース・アクティビティーは、サービス・サブクラスにマップされます。 つまり、ネスティング・レベルがゼロより大きいアクティビティーは、ネスティング・レベルがゼロのアクティビティーと同じサービス・クラスの下で実行されます。
WITHOUT NESTED
作業クラスの下に分類されているデータベース・アクティビティーのうち、ネスティング・レベルがゼロのものだけがサービス・サブクラスにマップされます。 このアクティビティーの下にネストされているデータベース・アクティビティーは、そのアクティビティー・タイプに従って処理されます。
TO service-subclass-name
アクティビティーのマップ先となるサービス・サブクラスを指定します。 service-subclass-name は、現行サーバーの service-superclass-name に既に存在するものでなければなりません (SQLSTATE 42704)。 service-subclass-name にデフォルトのサービス・サブクラス SYSDEFAULTSUBCLASS を指定することはできません (SQLSTATE 5U018)。
WHEN
この作業アクションが定義されている作業クラスに関連するデータベース・アクティビティーに適用するしきい値を指定します。 しきい値は、この作業アクション・セットが定義されているデータベース・マネージャー・オブジェクトがデータベースである場合にのみ指定できます (SQLSTATE 5U034)。 これらのしきい値は、データベース・マネージャーによって開始された内部のデータベース・アクティビティー、または管理 SQL ルーチンによって生成されたデータベース・アクティビティーには適用されません。
threshold-predicate-clause
有効なしきい値タイプについては、「CREATE THRESHOLD」ステートメントを参照してください。
threshold-exceeded-actions
しきい値を超過した場合の有効なアクションについては、「CREATE THRESHOLD」ステートメントを参照してください。
PREVENT EXECUTION
この作業アクションが定義されている作業クラスに関連するデータベース・アクティビティーの実行を許可しないことを指定します (SQLSTATE 5U033)。
COUNT ACTIVITY
作業クラスに関連するすべてのデータベース・アクティビティーを実行し、1 つのアクティビティーが実行されるたびに作業クラスのカウンターを増加させることを指定します。
COLLECT ACTIVITY DATA
この作業アクションが定義されている作業クラスに関連する各アクティビティーについてのデータを、アクティビティー完了時に、任意のアクティブなアクティビティー・イベント・モニターに送信するように指定します。
collect-activity-data-clause
ON COORDINATOR MEMBER
アクティビティーのコーディネーター・メンバーでのみ、アクティビティー・データを収集することを指定します。
ON ALL MEMBERS
アクティビティーが処理されるすべての メンバー でアクティビティー・データを収集することを指定します。予測しきい値の場合、しきい値を超過した場合の CONTINUE アクションも指定した場合にのみ、アクティビティー情報がすべてのメンバーで収集されます。 反応しきい値の場合、ON ALL MEMBERS 節を指定しても効果はなく、アクティビティー情報は常にコーディネーター メンバー でのみ収集されます。 予測しきい値および反応しきい値の両方について、 入力データ値、セクション情報、または値は、コーディネーター・メンバーでのみ収集されます。
WITHOUT DETAILS
この作業アクションが定義されている作業クラスに関連する各アクティビティーについてのデータを、アクティビティーの実行完了時に、任意のアクティブなアクティビティー・イベント・モニターに送信するように指定します。 ステートメント、コンパイル環境、 およびセクション環境のデータに関する詳細は送信されません。
WITH
DETAILS
任意のアクティブなアクティビティーにステートメントおよびコンパイル環境のデータが含まれる場合、 それを該当するアクティビティーのイベント・モニターへ送信すること を指定します。セクションの環境データは送信されません。
SECTION
任意のアクティブなアクティビティーにステートメント、コンパイル環境、およびセクション環境のデータが含まれる場合、 それを該当するアクティビティーのイベント・モニターへ送信すること を指定します。DETAILS は SECTION が指定されている場合、 指定する必要があります。
INCLUDE ACTUALS BASE
セクション actuals を、アクティビティー・データが収集されるすべてのパーティションでも収集することを示します。セクション actuals を収集するには、INCLUDE ACTUALS 節を指定するか、section_actuals データベース構成パラメーターを設定する必要があります。

セクション actuals の収集の有効な設定は、INCLUDE ACTUALS 節、section_actuals データベース構成パラメーター、および WLM_SET_CONN_ENV ルーチンで指定される <collectsectionactuals> 設定の組み合わせです。例えば、INCLUDE ACTUALS BASE を指定しても、section_actuals データベース構成パラメーターの値と <collectsectionactuals> を NONE に設定する場合、セクション actuals の収集の有効な設定は BASE になります。

BASE は、アクティビティーの実行時に、以下の実行時統計を有効化および収集する必要があることを指定します。
  • 基本演算子のカーディナリティー・カウント
  • 参照される各オブジェクトの統計 (DML ステートメントのみ)
AND VALUES
任意のアクティブなアクティビティーに入力データ値が含まれている場合、 それを該当するアクティビティーのイベント・モニターに送信することを指定します。
NONE
この作業アクションが定義されている作業クラスに関連付けられている各アクティビティーについてはアクティビティー・データを収集しないことを指定します。
COLLECT AGGREGATE ACTIVITY DATA
この作業アクションが定義されている作業クラスに関連するアクティビティーについて、集約アクティビティー・データをキャプチャーし、統計イベント・モニター (アクティブになっている場合) に送信することを指定します。この情報は、wlm_collect_int データベース構成パラメーターで指定されたインターバルにより周期的に収集されます。 デフォルトは COLLECT AGGREGATE ACTIVITY DATA BASE です。 この節は、データベースに適用される作業アクション・セットで定義されている作業アクションには指定できません。
BASE
この作業アクションが定義されている作業クラスに関連するアクティビティーについて、基礎集約アクティビティー・データをキャプチャーし、統計イベント・モニター (アクティブになっている場合) に送信することを指定します。基礎集約アクティビティー・データには以下のものが含まれます。
  • アクティビティー・コストの最高水準点の見積もり
  • 戻り行数の最高水準点
  • TEMPORARY 表スペース使用量の最高水準点。この最高水準点が関係するのは、SQLTEMPSPACE しきい値が適用されているアクティビティーのみです。
  • アクティビティー存続時間のヒストグラム
  • アクティビティー・キュー時間のヒストグラム
  • アクティビティー実行時間のヒストグラム
EXTENDED
この作業アクションが定義されている作業クラスに関連するアクティビティーについて、すべての集約アクティビティー・データをキャプチャーし、統計イベント・モニター (アクティブになっている場合) に送信することを指定します。これには、すべての基礎集約アクティビティー・データに加えて、以下のものが含まれます。
  • アクティビティー・データ操作言語 (DML) の見積コスト・ヒストグラム
  • アクティビティー DML の到着間隔時間のヒストグラム
ENABLE または DISABLE
データベース・アクティビティーをサブミットする際にこの作業アクションを考慮するかどうかを指定します。 デフォルトは ENABLE です。
ENABLE
この作業アクションが有効であり、データベース・アクティビティーのサブミット時に考慮することを指定します。
DISABLE
作業アクションが無効であり、データベース・アクティビティーのサブミット時に考慮の対象にならないことを指定します。
histogram-template-clause
この作業アクションの割り当て先の作業クラスに関連するアクティビティーの集約アクティビティー・データを収集する際に使用するヒストグラム・テンプレートを指定します。 作業クラスの集約アクティビティー・データが収集されるのは、作業アクション・タイプが COLLECT AGGREGATE ACTIVITY DATA となっている場合だけです。
ACTIVITY LIFETIME HISTOGRAM TEMPLATE template-name
特定の間隔で実行中のデータベース・アクティビティーの所要時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。この時間には、キューに入っていた時間と実行時間の両方が含まれます。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY QUEUETIME HISTOGRAM TEMPLATE template-name
データベース・アクティビティーが特定の間隔でキューに入れられている時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY EXECUTETIME HISTOGRAM TEMPLATE template-name
データベース・アクティビティーが特定の間隔で実行されている時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。この時間には、アクティビティーがキューに入っていた時間は含まれません。 このヒストグラムでは、アクティビティーが実行される各メンバー ごとにアクティビティーの実行時間が収集されます。 アクティビティーのコーディネーターのメンバーの場合、これはエンドツーエンドの実行時間です (つまり、存続時間からキューに入っていた時間を差し引いた時間)。 コーディネーター メンバー 以外の場合、これはこれらの メンバー がアクティビティーの代わりに費やした時間です。 特定のアクティビティーの実行中、データベース・マネージャーは、コーディネーターではないメンバーに対して作業を複数回提示することがあります。コーディネーターではないメンバーはそのたびにアクティビティーのオカレンスの実行時間を収集します。そのため、実行時間のヒストグラムの数は、メンバーで実行された固有アクティビティーの実際の数とは異なる場合があります。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY ESTIMATEDCOST HISTOGRAM TEMPLATE template-name
この作業アクションの割り当て先作業クラスに関連する DML アクティビティーの見積コスト (timeron 単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節とその EXTENDED オプションが指定されている場合にのみ収集されます。
ACTIVITY INTERARRIVALTIME HISTOGRAM TEMPLATE template-name
この作業アクションの割り当て先作業クラスに関連するすべてのアクティビティーについて、1 つの DML アクティビティーの到着から次の DML アクティビティーの到着までの間の時間の長さ (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節とその EXTENDED オプションが指定されている場合にのみ収集されます。
ALTER
作業アクションの定義を変更します。 この作業アクションが適用される作業クラス、およびその作業クラスに属するデータベース・アクティビティーに適用されるアクションを変更できます。
WORK ACTION work-action-name
作業アクションを識別します。work-action-name には、現行のサーバーに存在する作業アクションを、この作業アクション・セットの下に指定する必要があります (SQLSTATE 42704)。
SET WORK CLASS work-class-name
この作業アクションが適用されるデータベース・アクティビティーを識別する作業クラスを指定します。 work-class-name は、現行のサーバーの work-class-set-name に存在するものでなければなりません (SQLSTATE 42704)。
MAP ACTIVITY
アクティビティーのマッピングの作業アクションを指定します。 このアクションは、この作業アクション・セットが定義されているオブジェクトがサービス・スーパークラスである場合にのみ指定できます (SQLSTATE 5U034)。
WITH NESTED または WITHOUT NESTED
このアクティビティーの下にネストされているアクティビティーをサービス・サブクラスにマップするかどうかを指定します。 デフォルトは WITH NESTED です。
WITH NESTED
作業クラスに分類されているネスティング・レベルがゼロのすべてのデータベース・アクティビティー、およびこのアクティビティーの下にネストされているすべてのデータベース・アクティビティーが、サービス・サブクラスにマップされます。
WITHOUT NESTED
作業クラスの下に分類されているデータベース・アクティビティーのうち、ネスティング・レベルがゼロのものだけがサービス・サブクラスにマップされます。 このアクティビティーの下にネストされているデータベース・アクティビティーは、そのアクティビティー・タイプに従って処理されます。
TO service-subclass-name
アクティビティーのマップ先となるサービス・サブクラスを指定します。 service-subclass-name は、現行サーバーの service-superclass-name に既に存在するものでなければなりません (SQLSTATE 42704)。 service-subclass-name にデフォルトのサービス・サブクラス SYSDEFAULTSUBCLASS を指定することはできません (SQLSTATE 5U018)。
WHEN
この作業アクションが定義されている作業クラスに関連するデータベース・アクティビティーで変更されるしきい値を指定します。
threshold-predicate-clause
有効なしきい値タイプについては、「CREATE THRESHOLD」ステートメントを参照してください。
PERFORM ACTION
しきい値述部条件の値を変更する際に、アクションを超過するしきい値は変更しないように指定します。 作業アクションはしきい値でなければなりません (SQLSTATE 42613)。
alter-threshold-exceeded-actions
有効な alter-threshold-exceeded-action については、「CREATE THRESHOLD」ステートメントの threshold-exceeded-action を参照してください。
EXCEEDED
この変更済みしきい値にもともと指定されていたのと同じしきい値述部を保持するように指定します。 作業アクションはしきい値でなければなりません (SQLSTATE 42613)。
PREVENT EXECUTION
この作業アクションが定義されている作業クラスに関連するデータベース・アクティビティーの実行を許可しないことを指定します (SQLSTATE 5U033)。
COUNT ACTIVITY
作業クラスに関連するすべてのデータベース・アクティビティーを実行し、1 つのアクティビティーが実行されるたびに作業クラスのカウンターを増加させることを指定します。
COLLECT ACTIVITY DATA
この作業アクションが定義されている作業クラスに関連する各アクティビティーについてのデータを、アクティビティー完了時に、任意のアクティブなアクティビティー・イベント・モニターに送信するように指定します。
alter-collect-activity-data-clause
ON COORDINATOR MEMBER
アクティビティーのコーディネーター・メンバーでのみ、アクティビティー・データを収集することを指定します。
ON ALL MEMBERS
アクティビティーが処理されるすべてのメンバーでアクティビティー・データを収集することを指定します。リモート・メンバーでは、アクティビティーがそれらのメンバーで発生および終了するときに、アクティビティーの 1 レコードが複数回キャプチャーされる場合があります。 AND VALUES 節が指定されている場合は、コーディネーターのメンバーについてのみ、アクティビティー入力値が収集されます。
WITHOUT DETAILS
この作業アクションが定義されている作業クラスに関連する各アクティビティーについてのデータを、アクティビティーの実行完了時に、任意のアクティブなアクティビティー・イベント・モニターに送信するように指定します。 ステートメント、コンパイル環境、 およびセクション環境のデータに関する詳細は送信されません。
WITH
DETAILS
任意のアクティブなアクティビティーにステートメントおよびコンパイル環境のデータが含まれる場合、 それを該当するアクティビティーのイベント・モニターへ送信すること を指定します。セクションの環境データは送信されません。
SECTION
ステートメント、コンパイル環境、セクション環境データ、セクション actuals を、それらが含まれるアクティビティー用のアクティブなアクティビティー・イベント・モニターに送信することを指定します。DETAILS は SECTION が指定されている場合、 指定する必要があります。セクション actuals は、アクティビティー・データが収集されるすべてのメンバーで収集されます。
INCLUDE ACTUALS BASE
セクション actuals を、アクティビティー・データが収集されるすべてのパーティションでも収集することを示します。セクション actuals を収集するには、INCLUDE ACTUALS 節を指定するか、section_actuals データベース構成パラメーターを設定する必要があります。

セクション actuals の収集の有効な設定は、INCLUDE ACTUALS 節、section_actuals データベース構成パラメーター、および WLM_SET_CONN_ENV ルーチンで指定される <collectsectionactuals> 設定の組み合わせです。例えば、INCLUDE ACTUALS BASE を指定しても、section_actuals データベース構成パラメーターの値と <collectsectionactuals> を NONE に設定する場合、セクション actuals の収集の有効な設定は BASE になります。

BASE は、アクティビティーの実行時に、以下の実行時統計を有効化および収集する必要があることを指定します。
  • 基本演算子のカーディナリティー・カウント
  • 参照される各オブジェクトの統計 (DML ステートメントのみ)
AND VALUES
任意のアクティブなアクティビティーに入力データ値が含まれている場合、 それを該当するアクティビティーのイベント・モニターに送信することを指定します。
NONE
この作業アクションが定義されている作業クラスに関連付けられている各アクティビティーについてはアクティビティー・データを収集しないことを指定します。
COLLECT AGGREGATE ACTIVITY DATA
この作業アクションが定義されている作業クラスに関連するアクティビティーについて、集約アクティビティー・データをキャプチャーし、統計イベント・モニター (アクティブになっている場合) に送信することを指定します。この情報は、wlm_collect_int データベース構成パラメーターで指定されたインターバルにより周期的に収集されます。 デフォルトは COLLECT AGGREGATE ACTIVITY DATA BASE です。 この節は、データベースに適用される作業アクション・セットで定義されている作業アクションには指定できません。
BASE
この作業アクションが定義されている作業クラスに関連するアクティビティーについて、基礎集約アクティビティー・データをキャプチャーし、統計イベント・モニター (アクティブになっている場合) に送信することを指定します。基礎集約アクティビティー・データには以下のものが含まれます。
  • アクティビティー・コストの最高水準点の見積もり
  • 戻り行数の最高水準点
  • TEMPORARY 表スペース使用量の最高水準点
  • アクティビティー存続時間のヒストグラム
  • アクティビティー・キュー時間のヒストグラム
  • アクティビティー実行時間のヒストグラム
EXTENDED
この作業アクションが定義されている作業クラスに関連するアクティビティーについて、すべての集約アクティビティー・データをキャプチャーし、統計イベント・モニター (アクティブになっている場合) に送信することを指定します。これには、すべての基礎集約アクティビティー・データに加えて、以下のものが含まれます。
  • アクティビティー DML の見積コストのヒストグラム
  • アクティビティー DML の到着間隔時間のヒストグラム
ACTIVITY LIFETIME HISTOGRAM TEMPLATE template-name
特定の間隔で実行中のデータベース・アクティビティーの所要時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。この時間には、キューに入っていた時間と実行時間の両方が含まれます。 データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY QUEUETIME HISTOGRAM TEMPLATE template-name
データベース・アクティビティーが特定の間隔でキューに入れられている時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY EXECUTETIME HISTOGRAM TEMPLATE template-name
データベース・アクティビティーが特定の間隔で実行されている時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。この時間には、アクティビティーがキューに入っていた時間は含まれません。 このヒストグラムでは、アクティビティーが実行される各メンバー ごとにアクティビティーの実行時間が収集されます。 アクティビティーのコーディネーターのメンバーの場合、これはエンドツーエンドの実行時間です (つまり、存続時間からキューに入っていた時間を差し引いた時間)。 コーディネーター メンバー 以外の場合、これはこれらの メンバー がアクティビティーの代わりに費やした時間です。 特定のアクティビティーの実行中、データベース・マネージャーは、コーディネーターではないメンバーに対して作業を複数回提示することがあります。コーディネーターではないメンバーはそのたびにアクティビティーのオカレンスの実行時間を収集します。そのため、実行時間のヒストグラムの数は、メンバーで実行された固有アクティビティーの実際の数とは異なる場合があります。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY ESTIMATEDCOST HISTOGRAM TEMPLATE template-name
この作業アクションの割り当て先作業クラスに関連するデータ操作言語 (DML) アクティビティーの見積コスト (timeron 単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節とその EXTENDED オプションが指定されている場合にのみ収集されます。
ACTIVITY INTERARRIVALTIME HISTOGRAM TEMPLATE template-name
この作業アクションの割り当て先作業クラスに関連するすべてのアクティビティーについて、1 つの DML アクティビティーの到着から次の DML アクティビティーの到着までの間の時間の長さ (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節とその EXTENDED オプションが指定されている場合にのみ収集されます。
ENABLE または DISABLE
データベース・アクティビティーをサブミットする際にこの作業アクションを考慮するかどうかを指定します。
ENABLE
この作業アクションが有効であり、データベース・アクティビティーのサブミット時に考慮することを指定します。
DISABLE
作業アクションが無効であり、データベース・アクティビティーのサブミット時に考慮の対象にならないことを指定します。
DROP work-action-name
作業アクション・セットから作業アクションをドロップします。work-action-name には、現行のサーバーに存在する作業アクションを、この作業アクション・セットの下に指定する必要があります (SQLSTATE 42704)。

作業アクション・セットの一部として作成されたしきい値は、直接操作することはできません。 このしきい値を使用不可にするには、まず作業アクションを使用不可にする必要があります。 その後しきい値が使用されなくなると、作業アクションをドロップできます。 作業アクションのドロップについて詳しくは、『関連タスク』のセクションを参照してください。

ENABLE または DISABLE
データベース・アクティビティーをサブミットする際にこの作業アクション・セットを考慮するかどうかを指定します。
ENABLE
この作業アクション・セットが有効であり、データベース・アクティビティーのサブミット時に考慮することを指定します。
DISABLE
この作業アクション・セットが無効であり、データベース・アクティビティーのサブミット時に考慮の対象とならないことを指定します。

規則

  • ワークロード管理 (WLM) 排他 SQL ステートメントの後は COMMIT または ROLLBACK ステートメントでなければなりません (SQLSTATE 5U021)。 WLM 排他 SQL ステートメントは次のとおりです。
    • CREATE HISTOGRAM TEMPLATE、ALTER HISTOGRAM TEMPLATE、または DROP (ヒストグラム・テンプレート)
    • CREATE SERVICE CLASS、ALTER SERVICE CLASS、または DROP (サービス・クラス)
    • CREATE THRESHOLD、ALTER THRESHOLD、または DROP (しきい値)
    • CREATE WORK ACTION SET、ALTER WORK ACTION SET、または DROP (作業アクション・セット)
    • CREATE WORK CLASS SET、ALTER WORK CLASS SET、または DROP (作業クラス・セット)
    • CREATE WORKLOAD、ALTER WORKLOAD、または DROP (ワークロード)
    • GRANT (ワークロード特権) または REVOKE (ワークロード特権)
  • WLM 排他 SQL ステートメントをグローバル・トランザクション (例えば XA トランザクション) 内で発行することはできません (SQLSTATE 51041)。

注

  • 変更はシステム・カタログに書き込まれますが、コミットされるまでは有効になりません。 これは、ステートメントを発行する接続の場合でも当てはまります。
  • CONCURRENTDBCOORDACTIVITIES などのキューで使用されるしきい値は、無効にしてからドロップする必要があります。
  • 全パーティションを通じて、同時に実行できる非コミットの WLM 排他 SQL ステートメントは 1 つのみです。 非コミットの WLM 排他 SQL ステートメントが実行されている場合、後続の WLM 排他 SQL ステートメントは、現行の WLM 排他 SQL ステートメントがコミットまたはロールバックされるまで待機します。

例

  • 例 1: DATABASE_ACTIONS 作業アクション・セットに変更を加え、作業クラス LARGE_SELECTS を使用して 2 つの作業アクションを追加します。作業アクション ONE_CONCURRENT_SELECT では、一度に並行して実行できるアクティビティーの数を制御するために 1 をしきい値として適用し、キューに入れることのできるアクティビティーの最大数を 3 にします。作業アクション BIG_ROWS_RETURNED では、そのクラスに含まれるデータベース・アクティビティーから戻せる行の数を 1 000 000 に制限します。
       ALTER WORK ACTION SET DATABASE_ACTIONS
     ADD WORK ACTION ONE_CONCURRENT_SELECT ON WORK CLASS LARGE_SELECTS
        WHEN CONCURRENTDBCOORDACTIVITIES > 1
           AND QUEUEDACTIVITIES > 3 STOP EXECUTION
     ADD WORK ACTION BIG_ROWS_RETURNED ON WORK CLASS LARGE_SELECTS
        WHEN SQLROWSRETURNED > 1000000 STOP EXECUTION
  • 例 2: ADMIN_APPS_ACTIONS 作業アクション・セットに変更を加えて、MAP_SELECTS 作業アクションを変更し、作業クラス SELECT_CLASS の下のスーパー・サービス・クラス ADMIN_APPS で実行されるすべてのアクティビティーをサービス・サブクラス ALL_SELECTS にマップします。また、作業クラス UPDATE_CLASS で実行されるすべてのアクティビティーをサービス・サブクラス ALL_SELECTS にマップする、MAP_UPDATES という名前の新規作業アクションを追加します。
       ALTER WORK ACTION SET ADMIN_APPS_ACTIONS
     ALTER WORK ACTION MAP_SELECTS MAP ACTIVITY TO ALL_SELECTS
     ADD WORK ACTION MAP_UPDATES ON WORK CLASS UPDATE_CLASS
       MAP ACTIVITY TO ALL_SELECTS