ALTER WORK ACTION SET ステートメント

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

呼び出し

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

許可

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

構文

Read syntax diagramSkip visual syntax diagramALTER WORK ACTION SETwork-action-set-name 1ADDwork-action-definitionALTERwork-action-alterationDROPWORK ACTIONwork-action-name2ENABLEDISABLE
work-action-definition
Read syntax diagramSkip visual syntax diagramWORK ACTIONwork-action-name ON WORK CLASSwork-class-name action-types-clause histogram-template-clauseENABLEDISABLE
action-types-clause
Read syntax diagramSkip visual syntax diagramMAP ACTIVITYWITH NESTEDWITHOUT NESTEDTOservice-subclass-nameWHENthreshold-predicate-clausethreshold-exceeded-actionsPREVENT EXECUTIONCOUNT ACTIVITYCOLLECT ACTIVITY DATAcollect-activity-data-clauseCOLLECT AGGREGATE ACTIVITY DATABASEEXTENDED
threshold-predicate-clause
Read syntax diagramSkip visual syntax diagram3CONCURRENTDBCOORDACTIVITIES>integerAND QUEUEDACTIVITIES>integerAND QUEUEDACTIVITIES UNBOUNDEDSQLTEMPSPACE>integerKMGSQLROWSRETURNED>integerESTIMATEDSQLCOST>bigintCPUTIME>integer-valueHOURHOURSMINUTEMINUTESCHECKING EVERYinteger-valueSECONDSECONDSSQLROWSREAD>bigint-valueCHECKING EVERYinteger-valueSECONDSECONDSSORTSHRHEAPUTIL>integer-valuePERCENTAND BLOCKING ADMISSION FOR>integer-valueDAYDAYSHOURHOURSMINUTEMINUTESSECONDSACTIVITYTOTALTIME>integerDAYDAYSHOURHOURSMINUTEMINUTESSECONDSACTIVITYTOTALRUNTIME>integerDAYDAYSHOURHOURSMINUTEMINUTESSECONDS
threshold-exceeded-actions
Read syntax diagramSkip visual syntax diagramCOLLECT ACTIVITY DATA NONECOLLECT ACTIVITY DATAcollect-activity-data-clauseSTOP EXECUTIONCONTINUE
collect-activity-data-clause
Read syntax diagramSkip visual syntax diagramON COORDINATORMEMBERON ALLMEMBERSWITHOUT DETAILSWITH,DETAILS4SECTIONINCLUDE ACTUALS BASE5AND VALUES
histogram-template-clause
Read syntax diagramSkip visual syntax diagram 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
Read syntax diagramSkip visual syntax diagramWORK ACTIONwork-action-name 6SET WORK CLASSwork-class-namealter-action-types-clauseACTIVITY LIFETIME HISTOGRAM TEMPLATEtemplate-nameACTIVITY QUEUETIME HISTOGRAM TEMPLATEtemplate-nameACTIVITY EXECUTETIME HISTOGRAM TEMPLATEtemplate-nameACTIVITY ESTIMATEDCOST HISTOGRAM TEMPLATEtemplate-nameACTIVITY INTERARRIVALTIME HISTOGRAM TEMPLATEtemplate-nameENABLEDISABLE
alter-action-types-clause
Read syntax diagramSkip visual syntax diagramMAP 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
Read syntax diagramSkip visual syntax diagram78COLLECT ACTIVITY DATAalter-collect-activity-data-clauseNONESTOP EXECUTIONCONTINUE
alter-collect-activity-data-clause
Read syntax diagramSkip visual syntax diagramON COORDINATORMEMBERON ALLMEMBERSWITHOUT DETAILSWITH,DETAILS9SECTIONINCLUDE ACTUALS BASEAND VALUES
Notes:
  • 1 The ADD, ALTER, and DROP clauses are processed in the order in which they are specified.
  • 2 The ENABLE or DISABLE clause can only be specified once in the same statement.
  • 3 Only one work action of the same threshold type can be applied to a single work class at a time. When altering a threshold work action, the threshold predicate cannot be changed.
  • 4 The DETAILS keyword is the minimum to be specified, followed by the option separated by a comma.
  • 5 This clause does not apply to thresholds.
  • 6 The same clause must not be specified more than once.
  • 7 The same clause must not be specified more than once.
  • 8 If an existing work action does not have a threshold-exceeded action defined for it and it is being altered to become a threshold work action, then either STOP EXECUTION or CONTINUE must be specified, and if COLLECT ACTIVITY DATA is not specified, then COLLECT ACTIVITY DATA NONE is the default.
  • 9 The DETAILS keyword is the minimum to be specified, followed by the option separated by a comma.

説明

ワーク・アクション・セット名
変更する作業アクション・セットを識別します。 これは、1 部構成の名前です。 これは、SQL ID です (通常 ID または区切り ID)。 work-action-set-name には、現行のサーバー上の既存の作業アクション・セットを指定する必要があります (SQLSTATE 42704)。
ADD
作業アクション・セットに作業アクションを追加します。
WORK ACTION ワーク・アクション名
作業アクションの名前を指定します。 work-action-name は、現行のサーバーのこの作業アクション・セットの下に既存の作業アクションを識別するものであってはなりません (SQLSTATE 42710)。 work-action-name の先頭に SYS を使用することはできません (SQLSTATE 42939)。
ON WORK CLASS ワーク・クラス名
この作業アクションが適用されるデータベース・アクティビティーを識別する作業クラスを指定します。 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-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
任意のアクティブなアクティビティーにステートメント、コンパイル環境、およびセクション環境のデータが含まれる場合、 それを該当するアクティビティーのイベント・モニターへ送信すること を指定します。 DETAILSSECTION が指定されている場合、 指定する必要があります。
INCLUDE ACTUALS BASE
セクション actuals を、アクティビティー・データが収集されるすべてのパーティションでも収集することを示します。 セクション actuals を収集するには、INCLUDE ACTUALS 節を指定するか、section_actuals データベース構成パラメーターを設定する必要があります。

セクション actuals を収集するための有効な設定は、INCLUDE ACTUALS 節、section_actuals データベース構成パラメーター、および WLM_SET_CONN_ENV ルーチンで指定される <collectsectionactuals> 設定の組み合わせです。 例えば、INCLUDE ACTUALS BASE が指定されているが、section_actuals データベース構成パラメーター値が NONE であり、<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
作業アクションが無効であり、データベース・アクティビティーのサブミット時に考慮の対象にならないことを指定します。
ヒストグラム・テンプレート文節
この作業アクションの割り当て先の作業クラスに関連するアクティビティーの集約アクティビティー・データを収集する際に使用するヒストグラム・テンプレートを指定します。 作業クラスの集約アクティビティー・データが収集されるのは、作業アクション・タイプが COLLECT AGGREGATE ACTIVITY DATA となっている場合だけです。
アクティビティー存続時間ヒストグラム・テンプレート template-name
特定の間隔で実行中のデータベース・アクティビティーの所要時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。 この時間には、キューに入っていた時間と実行時間の両方が含まれます。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
アクティビティー・キュー時間ヒストグラム・テンプレート template-name
データベース・アクティビティーが特定の間隔でキューに入れられている時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY EXECUTETIME HISTOGRAM TEMPLATE テンプレート名
データベース・アクティビティーが特定の間隔で実行されている時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。 この時間には、アクティビティーがキューに入っていた時間は含まれません。 アクティビティー実行時間は、アクティビティーが実行される メンバー ごとにこのヒストグラムで収集されます。 アクティビティーのコーディネーター・ メンバーでは、これはエンドツーエンド実行時間 (つまり、存続時間からキューに入れられた時間を引いた時間) です。 非コーディネーター・ メンバーの場合、これは、これらの メンバー がアクティビティーのために作業に費やす時間です。 特定のアクティビティーの実行中に、データベース・マネージャーは非コーディネーター・ メンバー に複数回作業を提示する場合があり、非コーディネーター・ メンバー がそのアクティビティーのオカレンスの実行時間を収集するたびに、そのアクティビティーの実行時間を収集します。 したがって、実行時のヒストグラムのカウントは、 メンバーで実行された固有のアクティビティーの実際の数を表していない可能性があります。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY ESTIMATEDCOST HISTOGRAM TEMPLATE テンプレート名
この作業アクションの割り当て先作業クラスに関連する DML アクティビティーの見積コスト (timeron 単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節とその EXTENDED オプションが指定されている場合にのみ収集されます。
ACTIVITY INTERARRIVALTIME HISTOGRAM TEMPLATE テンプレート名
この作業アクションの割り当て先作業クラスに関連するすべてのアクティビティーについて、1 つの DML アクティビティーの到着から次の DML アクティビティーの到着までの間の時間の長さ (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節とその EXTENDED オプションが指定されている場合にのみ収集されます。
ALTER
作業アクションの定義を変更します。 この作業アクションが適用される作業クラス、およびその作業クラスに属するデータベース・アクティビティーに適用されるアクションを変更できます。
WORK ACTION ワーク・アクション名
作業アクションを識別します。 work-action-name には、現行のサーバーに存在する作業アクションを、この作業アクション・セットの下に指定する必要があります (SQLSTATE 42704)。
SET WORK CLASS ワーク・クラス名
この作業アクションが適用されるデータベース・アクティビティーを識別する作業クラスを指定します。 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-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-actions については、CREATE THRESHOLD ステートメントの threshold-exceeded-actions を参照してください。
EXCEEDED
この変更済みしきい値にもともと指定されていたのと同じしきい値述部を保持するように指定します。 作業アクションはしきい値でなければなりません (SQLSTATE 42613)。
PREVENT EXECUTION
この作業アクションが定義されている作業クラスに関連するデータベース・アクティビティーの実行を許可しないことを指定します (SQLSTATE 5U033)。
COUNT ACTIVITY
作業クラスに関連するすべてのデータベース・アクティビティーを実行し、1 つのアクティビティーが実行されるたびに作業クラスのカウンターを増加させることを指定します。
COLLECT ACTIVITY DATA
この作業アクションが定義されている作業クラスに関連する各アクティビティーについてのデータを、アクティビティー完了時に、任意のアクティブなアクティビティー・イベント・モニターに送信するように指定します。
alter-collect-activity-data-clause
ON COORDINATOR MEMBER
アクティビティーのコーディネーター・メンバーでのみ、アクティビティー・データを収集することを指定します。
ON ALL MEMBERS
アクティビティーが処理されるすべての メンバー でアクティビティー・データを収集することを指定します。 リモートの メンバーでは、アクティビティーがこれらの メンバーに到着および到着すると、アクティビティーのレコードが複数回キャプチャーされることがあります。 AND VALUES 節が指定されている場合、コーディネーターの メンバー についてのみアクティビティー入力値が収集されます。
WITHOUT DETAILS
この作業アクションが定義されている作業クラスに関連する各アクティビティーについてのデータを、アクティビティーの実行完了時に、任意のアクティブなアクティビティー・イベント・モニターに送信するように指定します。 ステートメント、コンパイル環境、 およびセクション環境のデータに関する詳細は送信されません。
WITH
DETAILS
任意のアクティブなアクティビティーにステートメントおよびコンパイル環境のデータが含まれる場合、 それを該当するアクティビティーのイベント・モニターへ送信すること を指定します。 セクションの環境データは送信されません。
SECTION
ステートメント、コンパイル環境、セクション環境データ、セクション actuals を、それらが含まれるアクティビティー用のアクティブなアクティビティー・イベント・モニターに送信することを指定します。 DETAILSSECTION が指定されている場合、 指定する必要があります。 セクション 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 データベース構成パラメーター値が NONE であり、<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 の到着間隔時間のヒストグラム
アクティビティー存続時間ヒストグラム・テンプレート template-name
特定の間隔で実行中のデータベース・アクティビティーの所要時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 この時間には、キューに入っていた時間と実行時間の両方が含まれます。 データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
アクティビティー・キュー時間ヒストグラム・テンプレート template-name
データベース・アクティビティーが特定の間隔でキューに入れられている時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY EXECUTETIME HISTOGRAM TEMPLATE テンプレート名
データベース・アクティビティーが特定の間隔で実行されている時間 (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 データベース・アクティビティーは、この作業アクションの割り当て先の作業クラスに関連するアクティビティーです。 この時間には、アクティビティーがキューに入っていた時間は含まれません。 アクティビティー実行時間は、アクティビティーが実行される メンバー ごとにこのヒストグラムで収集されます。 アクティビティーのコーディネーター・ メンバーでは、これはエンドツーエンド実行時間 (つまり、存続時間からキューに入れられた時間を引いた時間) です。 非コーディネーター・ メンバーの場合、これは、これらの メンバー がアクティビティーのために作業に費やす時間です。 特定のアクティビティーの実行中に、データベース・マネージャーは非コーディネーター・ メンバー に複数回作業を提示する場合があり、非コーディネーター・ メンバー がそのアクティビティーのオカレンスの実行時間を収集するたびに、そのアクティビティーの実行時間を収集します。 したがって、実行時のヒストグラムのカウントは、 メンバーで実行された固有のアクティビティーの実際の数を表していない可能性があります。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節と、その BASE または EXTENDED のどちらかのオプションが指定されている場合にのみ収集されます。
ACTIVITY ESTIMATEDCOST HISTOGRAM TEMPLATE テンプレート名
この作業アクションの割り当て先作業クラスに関連するデータ操作言語 (DML) アクティビティーの見積コスト (timeron 単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節とその EXTENDED オプションが指定されている場合にのみ収集されます。
ACTIVITY INTERARRIVALTIME HISTOGRAM TEMPLATE テンプレート名
この作業アクションの割り当て先作業クラスに関連するすべてのアクティビティーについて、1 つの DML アクティビティーの到着から次の DML アクティビティーの到着までの間の時間の長さ (ミリ秒単位) に関する統計データを収集するために使用されるヒストグラムを記述するテンプレートを指定します。 デフォルトは SYSDEFAULTHISTOGRAM です。 この情報は、COLLECT AGGREGATE ACTIVITY DATA 節とその EXTENDED オプションが指定されている場合にのみ収集されます。
ENABLE または DISABLE
データベース・アクティビティーをサブミットする際にこの作業アクションを考慮するかどうかを指定します。
ENABLE
この作業アクションが有効であり、データベース・アクティビティーのサブミット時に考慮することを指定します。
DISABLE
作業アクションが無効であり、データベース・アクティビティーのサブミット時に考慮の対象にならないことを指定します。
DROP ワーク・アクション名
作業アクション・セットから作業アクションをドロップします。 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 ステートメントがコミットまたはロールバックされるまで待機します。
  • 代替構文: Db2® の以前のバージョンおよび他のデータベース製品との互換性のために、以下の代替の構文がサポートされています。 これらの代替は非標準であり、使用すべきではありません。
    • DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数が ON に設定されている場合を除き、DATABASE PARTITION を MEMBER の代わりに指定できます。
    • DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数が ON に設定されている場合を除き、DATABASE PARTITIONS を MEMBERS の代わりに指定できます。

  • 例 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