CREATE THRESHOLD ステートメント

CREATE THRESHOLD ステートメントはしきい値を定義します。

呼び出し

このステートメントは、アプリケーション・プログラムに組み込んだり、動的 SQL ステートメントを使用して発行したりすることができます。これは、DYNAMICRULES の実行動作がパッケージに効力を持つ場合にのみ、動的に準備できる実行可能ステートメントです (SQLSTATE 42509)。

許可

このステートメントの許可 ID が持つ特権には、WLMADM または DBADM 権限が含まれている必要があります。

説明

しきい値名しきい値に名前を付けます。これは、1 部構成の名前です。これは、SQL ID です (通常 ID または区切り ID)。 threshold-name は、現行のサーバー上に既存のしきい値を識別するものであってはなりません (SQLSTATE 42710)。名前を文字 SYS で始めることはできません (SQLSTATE 42939)。

FOR threshold-domain アクティビティー

しきい値の定義ドメインを指定します。

データベース

このしきい値はデータベース内のすべてのアクティビティーに適用されます。

SERVICE CLASS サービス・クラス名

このしきい値は、サービス・クラス service-class-name 内で実行中のアクティビティーに適用されます。 UNDER が指定されない場合、service-class-name には既存のサービス・スーパークラスを指定する必要があります (SQLSTATE 42704)。 UNDER が指定される場合は、service-class-name には UNDER キーワードの後に指定されるサービス・スーパークラスの既存のサービス・サブクラスを指定する必要があります (SQLSTATE 42704)。 service-class-name は、SYSDEFAULTSYSTEMCLASS サービス・クラスまたは SYSDEFAULTMAINTENANCECLASS サービス・クラスにすることはできません (SQLSTATE 5U032)。

UNDER サービス・クラス名: サービス・スーパークラスを指定します。 service-class-name には既存のサービス・スーパークラスを指定する必要があります (SQLSTATE 42704)。

STATEMENT

このしきい値は、特定の SQL ステートメントのアクティビティーに適用されます。しきい値に使用するステートメントを特定するには、ステートメント・テキストまたはステートメントの実行可能 ID を指定します。

TEXT ステートメント-テキスト

このしきい値は、statement-text で指定されたテキストと一致するステートメントに適用されます。しきい値の条件が評価されるとき、静的 SQL ステートメントと動的 SQL ステートメントの両方が考慮されます。実行時にしきい値違反になるのは、statement-text に指定されたテキストがパッケージ・キャッシュ内のステートメントのテキストと完全一致になる場合です。大/小文字や空白文字の使用に違いがあると、statement-text と実行中の SQL ステートメントとは一致しなくなります。 statement-text のテキストは、ストリング定数として指定する必要があります。そのため、ステートメントしきい値におけるステートメントのテキスト最大長は 32 672 バイトであり、ステートメントに対する通常の上限の 2 MB ではありません。

アクセス・プランの相違はステートメントの一致には影響を及ぼしません。 statement-text で定義されたしきい値テキストと同じテキストを持つキャッシュ・ステートメントが複数存在する場合、アクセス・プランが異なっていてもすべて一致します。

statement-text に指定されたステートメントと一致するステートメントがコンパイル中に変更または変換され、statement-text とは異なるステートメントになった場合、それらは一致しません。例えば、ステートメント・コンセントレーターが使用可能である場合、リテラル値はパラメーター・マーカーによって置換される場合があります。 CREATE THRESHOLD ステートメントの statement-text に指定されたテキストには、そのような変換は適用されません。 CREATE THRESHOLD で指定されるテキストは、対象となるすべてのステートメントの変換済みテキストと完全一致する必要があります。 MON_GET_PKG_CACHE_STMT や MON_GET_ACTIVITY_DETAILS などのモニター表関数を使用して、実行されるステートメントの正確なテキストを判別することができます。

ステートメントのしきい値には、以下の述部を使用できます。

ACTIVITYTOTALRUNTIME
ACTIVITYTOTALTIME
CPUTIME
ESTIMATEDSQLCOST
SQLROWSREAD
SQLROWSRETURNED
SQLTEMPSPACE

REFERENCE 実行可能プログラム ID

このしきい値は、指定された実行可能 ID を伴うステートメントのテキストと一致するテキストを持つステートメントに適用されます。データベース・マネージャーは、パッケージ・キャッシュ内で、実行可能 ID を使用してステートメントのテキストのセクションからそのテキストを見つけます。しきい値に使用されるステートメントのテキストは、しきい値が作成されたときにそのセクションにキャッシュされたテキストです。動的 SQL の場合、実行可能 ID で参照されるステートメントはパッケージ・キャッシュ内に存在している必要があります。静的 SQL の場合、ステートメントがキャッシュ内に存在しなければ、データベース・マネージャーはシステム・カタログからステートメントを取り出します。

パッケージ・キャッシュからステートメント・テキストが取り出されると、しきい値と指定実行可能ファイル ID との間には直接の関係はなくなります。キャッシュされたセクションは、そのキャッシュから得られたしきい値に影響を与えることなくキャッシュから退避させることさえできます。実行可能 ID と関連付けられたテキストが判別されると、この節によって作成されたしきい値は、STATEMENT TEXT 節で作成されたしきい値とまったく同様に機能します。

WORKLOAD ワークロード名

このしきい値は指定されたワークロードに適用されます。 workload-name には既存のワークロードを指定する必要があります (SQLSTATE 42704)。

ENFORCEMENT enforcement-scope

しきい値の強制の有効範囲。

DEFAULT: しきい値のデフォルトの適用範囲が使用されます。
データベース: しきい値は、定義ドメイン内のすべてのメンバー (つまり、データベースのすべてのメンバー、およびサービス・クラスのすべてのメンバー ) に適用されます。
メンバー: しきい値は、メンバーごとに適用されます。しきい値を適用するためのすべてのメンバー間の調整はありません。
WORKLOAD OCCURRENCE: しきい値は、ワークロード・オカレンス内でのみ強制されます。同じメンバー上で並行して実行されている 2 つのワークロード・オカレンスは、それぞれこのしきい値に対して独自の実行カウントを持ちます。

ENABLE または DISABLE

データベース・マネージャーでしきい値を使用可能にするかどうかを指定します。

ENABLE: データベース・アクティビティーの実行を制限するために、データベース・マネージャーでしきい値を使用します。
DISABLE: データベース・アクティビティーの実行を制限するためにデータベース・マネージャーでしきい値を使用しません。

WHEN しきい値述部

しきい値の条件を指定します。

TOTALMEMBERCONNECTIONS > 整数値

この条件は、メンバー上で並行して実行できるコーディネーター接続の数の上限を定義します。この値には、ゼロまたは任意の正整数を指定できます (SQLSTATE 42820)。値ゼロは、新しいコーディネーター接続を接続させないことを意味します。現在実行中の接続やキューに入っている接続は続行されます。この条件の定義ドメインは DATABASE でなければならず、強制の有効範囲は MEMBER にする必要があります (SQLSTATE 5U037)。このしきい値は、DBADM 権限または WLMADM 権限を持つユーザーには適用されません。

TOTALSCMEMBERCONNECTIONS > 整数値

この条件は、特定のサービス・スーパークラスのメンバーで並行して実行できるコーディネーター接続の数の上限を定義します。この値には、ゼロまたは任意の正整数を指定できます (SQLSTATE 42820)。値ゼロは、新しい接続をサービス・クラスに結合しないことを意味します。現在実行中の接続やキューに入っている接続は続行されます。この条件の定義ドメインは SERVICE SUPERCLASS でなければならず、適用範囲は MEMBER でなければなりません (SQLSTATE 5U037)。

AND QUEUEDCONNECTIONS > integer-value または AND QUEUEDCONNECTIONS UNBOUNDED: コーディネーター接続が最大数を超えた場合のキュー・サイズを指定します。この値には、ゼロを含む任意の正整数を指定できます (SQLSTATE 42820)。値ゼロは、コーディネーター接続をキューに入れないことを意味します。 UNBOUNDED を指定した場合は、指定されたコーディネーター接続の最大数を超えた接続がすべてキューに入れられ、threshold-exceeded-actions は実行されません。デフォルトはゼロです。

この条件は、データベース・マネージャーが接続をアイドル状態のままにしておく時間の上限を定義します。この値には、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。有効な期間キーワードを使用して、integer-value に適切な時間の単位を指定してください。この条件の定義ドメインは DATABASE または SERVICE SUPERCLASS でなければならず、強制の有効範囲は DATABASE にする必要があります (SQLSTATE 5U037)。この条件は、コーディネーター・メンバーで適用されます。

STOP EXECUTION アクションを CONNECTIONIDLETIME しきい値とともに指定した場合、しきい値を超過すると、アプリケーションの接続はドロップされます。それ以降にアプリケーションがデータ・サーバーへのアクセスを試行すると、SQLSTATE 5U026 を受け取ります。

このしきい値の最大値は 2 147 483 640 秒です。 2 147 483 640 秒よりも長い秒に相当する値が指定された場合は、この秒数に設定されます。

CONCURRENTWORKLOADOCCURRENCES > 整数値

この条件は、各メンバー上のワークロードの並行オカレンス数の上限を定義します。この値には、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。この条件の定義ドメインは WORKLOAD でなければならず、強制の有効範囲は MEMBER にする必要があります (SQLSTATE 5U037)。

CONCURRENTWORKLOADACTIVITIES > 整数値

この条件は、各メンバー上のワークロードの並行コーディネーター・アクティビティーおよびネストされたアクティビティーの数の上限を定義します。この値には、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。この条件の定義ドメインは WORKLOAD でなければならず、この条件の強制の有効範囲は WORKLOAD OCCURRENCE にする必要があります (SQLSTATE 5U037)。

ネストされるアクティビティーは、それぞれ以下の条件を満たしている必要があります。

認識されているコーディネーター・アクティビティーである必要があります。認識されているアクティビティーのタイプに含まれないネストされたコーディネーター・アクティビティーは、カウントされません。同じように、リモート・ノード要求などのネストされたサブエージェント・アクティビティーもカウントされません。
SQL ステートメントを発行するユーザー作成のプロシージャーなどの、ユーザー・ロジックから直接呼び出される必要があります。

制約の設定やマテリアライズ照会表のリフレッシュによって開始されたりする内部 SQL アクティビティーも、このしきい値のためにカウントされることはありません。こうしたアクティビティーはデータベース・マネージャーによって開始され、ユーザー・ロジックによって直接呼び出されるわけではないからです。

CONCURRENTDBCOORDACTIVITIES > 整数値

この条件は、指定されたドメイン内のすべてのメンバーで同時に実行できる、認識されるデータベース・コーディネーター・アクティビティーの数の上限を定義します。この値には、ゼロまたは任意の正整数を指定できます (SQLSTATE 42820)。値ゼロは、新しいデータベース・コーディネーター・アクティビティーを実行しないことを意味します。現在実行中またはキューに入っているデータベース・コーディネーター・アクティビティーは続行されます。この条件の定義ドメインは DATABASE、作業アクション (作業アクションの定義ドメインのしきい値は CREATE WORK ACTION SET または ALTER WORK ACTION SET ステートメントを使用して作成され、作業アクション・セットがワークロードまたはデータベースに適用されなければならない)、SERVICE SUPERCLASS、または SERVICE SUBCLASS でなければなりません。また、適用範囲は、 Db2® pureScale®以外の環境では DATABASE (SQLSTATE 5U037) でなければなりません。この場合、条件はデータベース全体に適用され、 Db2 pureScale で MEMBER (SQLSTATE 5U037) はコーディネーター・メンバーごとに適用されます。以下の項目を除くすべてのアクティビティーがこの条件によって追跡されます。

CALL ステートメントはこのしきい値によって制御されませんが、呼び出されるルーチン内で開始されるネストされたすべての子アクティビティーは、このしきい値によって制御されます。無名ブロックと自律型ルーチンは CALL ステートメントとして分類されます。
ユーザー定義関数はこのしきい値によって制御されますが、ユーザー定義関数の中でネストされた子アクティビティーは制御されません。ユーザー定義関数の中から自律型ルーチンが呼び出される場合、自律型ルーチンも、その自律型ルーチンの子アクティビティーも、しきい値には制御されません。
CALL ステートメントおよびこれらの CALL ステートメントの子アクティビティーを起動するトリガー・アクションは、このしきい値によって制御されません。トリガーをアクティブ化させる可能性のある INSERT、UPDATE、DELETE ステートメントは、引き続きしきい値に制御されます。
CALL ステートメントとの並行性の管理に、TOTALSCPARTITIONCONNECTIONS しきい値を使用できる場合があります。ワークロードが一時接続で構成されている場合、CALL ステートメントの並行性の制御には TOTALSCPARTITIONCONNECTIONS しきい値が有効です。一時接続は、プロシージャー呼び出し時にのみ確立される接続です。ワークロードが存続時間の長い接続で構成されている場合、TOTALSCPARTITIONCONNECTIONS しきい値は適切ではありません。

しきい値がワーク・アクション・セットの一部として定義されている場合、適用範囲は現在の環境 (現在の環境が Db2 pureScaleの場合は MEMBER、それ以外の場合は DATABASE) に基づいて自動的に決定されます。

重要: CONCURRENTDBCOORDACTIVITIES しきい値を使用する前に、データベース・システムに与える可能性のある影響についてよく理解しておいてください。

詳しくは、 CONCURRENTDBCOORDACTIVITIES しきい値を参照してください。

AND QUEUEDACTIVITIES > integer-value または AND QUEUEDACTIVITIES UNBOUNDED: データベース・コーディネーター・アクティビティーが最大数を超えた場合のキュー・サイズを指定します。この値には、ゼロまたは任意の正整数を指定できます (SQLSTATE 42820)。値ゼロは、データベース・コーディネーター・アクティビティーをキューに入れないことを意味します。 UNBOUNDED を指定した場合、指定されたデータベース・コーディネーター・アクティビティーの最大数を超えたデータベース・コーディネーター・アクティビティーがすべてキューに入れられ、threshold-exceeded-actions は実行されません。デフォルトはゼロです。
注: キューイングしきい値に対して CONTINUE のしきい値アクションが指定されている場合、キュー・サイズにハード値が指定されているかどうかに関係なく、キューのサイズは事実上無制限になります。

ESTIMATEDSQLCOST > bigint-value

この条件は、アクティビティーのオプティマイザー割り当てコスト (timeron 単位) の上限を定義します。この値には、任意の正の 64 ビット整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。この条件の定義ドメインは DATABASE、作業アクション (作業アクション定義ドメインのしきい値は CREATE WORK ACTION SET または ALTER WORK ACTION SET ステートメントを使用して作成される。作業アクション・セットがワークロードまたはデータベースに適用されなければならない)、SERVICE SUPERCLASS、SERVICE SUBCLASS、または WORKLOAD でなければならず、強制の有効範囲は DATABASE にする必要があります (SQLSTATE 5U037)。この条件は、コーディネーター・メンバーで適用されます。この条件では、以下のアクティビティーが追跡されます。

データ操作言語 (DML) タイプのコーディネーター・アクティビティー。
ユーザー・ロジックから呼び出されるネストされた DML アクティビティー。したがって、内部 SQL によってデータベース・マネージャーから開始できる DML アクティビティーは、この条件では追跡されません (ただし、コストが親の見積もりに含まれている場合は、これらのアクティビティーは間接的に追跡されます)。

SQLROWSRETURNED > 整数値

この条件は、アプリケーション・サーバーからクライアント・アプリケーションに戻される行の数の上限を定義します。この値には、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。この条件の定義ドメインは DATABASE、作業アクション (作業アクション定義ドメインのしきい値は CREATE WORK ACTION SET または ALTER WORK ACTION SET ステートメントを使用して作成される。作業アクション・セットがワークロードまたはデータベースに適用されなければならない)、SERVICE SUPERCLASS、SERVICE SUBCLASS、または WORKLOAD でなければならず、強制の有効範囲は DATABASE にする必要があります (SQLSTATE 5U037)。この条件は、コーディネーター・メンバーで適用されます。この条件では、以下のアクティビティーが追跡されます。

DML タイプのコーディネーター・アクティビティー。
ユーザー・ロジックから派生するネストされた DML アクティビティー。内部 SQL によってデータベース・マネージャーから開始されたアクティビティーは、この条件による影響を受けません。

プロシージャー内から戻される結果セットは、個々のアクティビティーとして別個に扱われます。プロシージャーそのものから戻される行の集約はありません。

この条件は、アクティビティーがキューに入れられている時間を含んだ、データベース・マネージャーがアクティビティーの実行のために許可する時間の上限を定義します。この条件の定義ドメインは DATABASE、作業アクション (作業アクション定義ドメインのしきい値は CREATE WORK ACTION SET または ALTER WORK ACTION SET ステートメントを使用して作成される。作業アクション・セットがワークロードまたはデータベースに適用されなければならない)、SERVICE SUPERCLASS、SERVICE SUBCLASS、または WORKLOAD でなければならず、強制の有効範囲は DATABASE にする必要があります (SQLSTATE 5U037)。この条件は、コーディネーター・メンバーで論理的に適用されます。

指定する integer-value は、ゼロより大きい整数でなければなりません (SQLSTATE 42820)。有効な期間キーワードを使用して、integer-value に適切な時間の単位を指定してください。指定する時間単位が SECONDS の場合、値は 10 の倍数でなければなりません (SQLSTATE 42615)。このしきい値に指定できる最大値は 2 147 483 640 秒です。 (DAY、HOUR、MINUTE、SECONDS 時間単位を使用して) 最大値よりも長い秒に相当する値が指定された場合は、エラーが戻されます (SQLSTATE 42615)。

この条件は、データベース・マネージャーが作業単位の実行を許可する時間の上限を定義します。この値には、ゼロ以外の正整数を指定できます (SQLSTATE 42820)。有効な期間キーワードを使用して、integer-value に適切な時間の単位を指定してください。指定する時間単位が SECONDS の場合、値は 10 の倍数でなければなりません (SQLSTATE 42615)。この条件の定義ドメインは DATABASE、SERVICE SUPERCLASS、または WORKLOAD でなければならず、強制の有効範囲は DATABASE にする必要があります (SQLSTATE 5U037)。この条件は、コーディネーター・メンバーで適用されます。

このしきい値に指定できる最大値は 2 147 483 640 秒です。 (DAY、HOUR、MINUTE、SECONDS 時間単位を使用して) 最大値よりも長い秒に相当する値が指定された場合は、エラーが戻されます (SQLSTATE 42615)。

SQLTEMPSPACE > 整数値 K | M | G

この条件は、メンバー上の SQL ステートメントによって消費できるシステム一時スペースの最大量を定義します。この値には、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。

integer-value K (大文字または小文字のどちらでも可) を指定した場合、最大サイズは integer-value の 1024 倍です。 integer-value M を指定した場合は、最大サイズは integer-value の 1 048 576 倍です。 integer-value G を指定した場合は、最大サイズは integer-value の 1 073 741 824 倍です。

この条件の定義ドメインは DATABASE、作業アクション (作業アクション定義ドメインのしきい値は CREATE WORK ACTION SET または ALTER WORK ACTION SET ステートメントを使用して作成され、作業アクション・セットはワークロードまたはデータベースに適用される必要があります)、SERVICE SUPERCLASS、SERVICE SUBCLASS、または WORKLOAD、および適用範囲は MEMBER (SQLSTATE 5U037) でなければなりません。この条件では、以下のアクティビティーが追跡されます。

DML タイプのコーディネーター・アクティビティーと、それに対応するサブエージェント作業 (サブセクション実行)。
ユーザー・ロジックから派生するネストされた DML アクティビティーと、それに対応するサブエージェント作業 (サブセクション実行)。内部 SQL によってデータベース・マネージャーから開始されたアクティビティーは、この条件による影響を受けません。

AGGSQLTEMPSPACE > 整数値 K | M | G

この条件は、メンバー上のサービス・クラスの一連のステートメントによって消費できるシステム一時スペースの最大量を定義します。この値には、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。

integer-value K (大文字または小文字のどちらでも可) を指定した場合、最大サイズは integer-value の 1024 倍です。 integer-value M を指定した場合は、最大サイズは integer-value の 1 048 576 倍です。 integer-value G を指定した場合は、最大サイズは integer-value の 1 073 741 824 倍です。

この条件の定義ドメインは SERVICE SUBCLASS でなければならず、強制の有効範囲は MEMBER にする必要があります (SQLSTATE 5U037)。

この条件で追跡される集合に関係するアクティビティーは次のとおりです。

DML タイプのコーディネーター・アクティビティーと、それに対応するサブエージェント作業 (サブセクション実行など)。
ユーザー・ロジックから派生するネストされた DML アクティビティーと、それに対応するサブエージェント作業 (サブセクション実行など)。内部 SQL ステートメントによってデータベース・マネージャーから開始されたアクティビティーは、この条件による影響を受けません。

SQLROWSREAD > bigint-値

この条件は、特定のメンバーに対するアクティビティーの存続期間中に、そのアクティビティーが読み取ることができる行数の上限を定義します。この値には、任意の正の 64 ビット整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。読み取られる行数は返される行数とは異なることに注意してください。返される行数は、SQLROWSRETURNED 条件によって制御されます。

この条件の定義ドメインは、DATABASE、SERVICE CLASS、サービス・サブクラス (UNDER 節を指定する SERVICE CLASS)、WORKLOAD、または作業アクション (作業アクション定義ドメインのしきい値は CREATE WORK ACTION SET または ALTER WORK ACTION SET ステートメントを使用して作成される。作業アクション・セットがワークロードまたはデータベースに適用されなければならない) でなければならず、強制の有効範囲は MEMBER にする必要があります (SQLSTATE 5U037)。この条件は、メンバーごとに独立して適用されます。

この条件では、以下のアクティビティーが追跡されます。

DML タイプのコーディネーター・アクティビティーと、それに対応するサブエージェント作業 (サブセクション実行など)。
制約の設定やマテリアライズ照会表のリフレッシュによって開始されるアクティビティーなどの内部 SQL アクティビティーも、データベース・マネージャーによって開始されるもので、ユーザー・ロジックによって直接呼び出されるものではないため、このしきい値には追跡されません。

CHECKING EVERY 整数値 SECOND | SECONDS: アクティビティーのしきい値条件がチェックされる頻度を指定します。しきい値は、各要求 (フェッチ操作など) の最後に、CHECKING 節によって定義された間隔でチェックされます。 CHECKING 節は、しきい値違反がある場合に、それが検出されない状態が続く時間の上限を定義します。デフォルトは 60 秒です。この値には、86400 秒を上限として、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。低い値を設定すると、システム性能に悪影響を与える可能性があります。

SQLROWSREADINSC > bigint-value

この条件は、サービス・サブクラスでの実行中に特定のメンバーのアクティビティーが読み取ることができる行数の上限を定義します。指定したサービス・サブクラスでの実行前に読み取られる行はカウントされません。この値には、任意の正の 64 ビット整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。読み取られる行数は返される行数とは異なることに注意してください。返される行数は、SQLROWSRETURNED 条件によって制御されます。

この条件の定義ドメインはサービス・サブクラス (UNDER 節を指定する SERVICE CLASS) でなければならず、強制の有効範囲は MEMBER にする必要があります (SQLSTATE 5U037)。この条件は、メンバーごとに独立して適用されます。

この条件では、以下のアクティビティーが追跡されます。

DML タイプのコーディネーター・アクティビティーと、それに対応するサブエージェント作業 (サブセクション実行など)。
制約の設定やマテリアライズ照会表のリフレッシュによって開始されるアクティビティーなどの内部 SQL アクティビティーも、データベース・マネージャーによって開始されるもので、ユーザー・ロジックによって直接呼び出されるものではないため、このしきい値には追跡されません。

CHECKING EVERY 整数値 SECOND | SECONDS: アクティビティーのしきい値条件がチェックされる頻度を指定します。しきい値は、各要求 (フェッチ操作など) の最後に、CHECKING 節によって定義された間隔でチェックされます。 CHECKING 節は、しきい値違反がある場合に、それが検出されない状態が続く時間の上限を定義します。デフォルトは 60 秒です。この値には、86400 秒を上限として、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。低い値を設定すると、システム性能に悪影響を与える可能性があります。

この条件は、特定のメンバー上でアクティビティーがその存続期間中に消費できるプロセッサー時間の上限を定義します。このしきい値で追跡されるプロセッサー時間は、アクティビティーの実行開始時刻から計測されます。この値には、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。

この条件の定義ドメインは、 DATABASE、サービス・スーパークラス (SERVICE CLASS)、サービス・サブクラス (UNDER 節を指定する SERVICE CLASS)、WORKLOAD、または作業アクション (作業アクション定義ドメインのしきい値は CREATE WORK ACTION SET または ALTER WORK ACTION SET ステートメントを使用して作成される。作業アクション・セットがワークロードまたはデータベースに適用されなければならない) でなければならず、強制の有効範囲は MEMBER にする必要があります (SQLSTATE 5U037)。この条件は、メンバーごとに独立して適用されます。

この条件では、以下のアクティビティーが追跡されます。

DML タイプのコーディネーター・アクティビティーと、それに対応するサブエージェント作業 (サブセクション実行など)。
制約の設定やマテリアライズ照会表のリフレッシュによって開始されるアクティビティーなどの内部 SQL アクティビティーも、データベース・マネージャーによって開始されるもので、ユーザー・ロジックによって直接呼び出されるものではないため、このしきい値には追跡されません。
タイプ CALL のアクティビティー。 CALL アクティビティーでは、プロシージャーのために追跡されるプロセッサー時間には、子アクティビティーまたは fenced モード・プロセスで使用されるプロセッサー時間は含まれません。このしきい値条件は、ユーザー・ロジックからデータベース・エンジンへの戻りでのみチェックされます。例えば、トラステッド・ルーチンの実行中にしきい値条件がチェックされるのは、そのルーチンがデータベース・エンジンに要求を発行するときのみです。

CHECKING EVERY 整数値 SECOND | SECONDS: アクティビティーのしきい値条件がチェックされる頻度を指定します。 CPUTIME しきい値の細分度は、この数値にアクティビティーの並列処理の度合いを乗算したものとほぼ等しくなります。例えば、しきい値が 60 秒ごとにチェックされ、並列処理の度合いが 2 である場合、アクティビティーが、しきい値違反が検出される前に、プロセッサー時間を 1 分ではなく、余分に 2 分使用することがあります。デフォルトは 60 秒です。この値には、86400 秒を上限として、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。低い値を設定すると、システム性能に悪影響を与える可能性があります。

この条件は、特定のメンバーが特定のサービス・サブクラスで実行されている間に、そのメンバーでアクティビティーが消費できるプロセッサー時間の上限を定義します。このしきい値で追跡されるプロセッサー時間は、しきい値ドメインで識別されるサービス・サブクラス内でのアクティビティーの実行開始時刻から計測されます。その時点より前に使用されるプロセッサー時間は、このしきい値が課す制限の対象にはなりません。この値には、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。

この条件では、以下のアクティビティーが追跡されます。

DML タイプのコーディネーター・アクティビティーと、それに対応するサブエージェント作業 (サブセクション実行など)。
制約の設定やマテリアライズ照会表のリフレッシュによって開始されるアクティビティーなどの内部 SQL アクティビティーも、データベース・マネージャーによって開始されるもので、ユーザー・ロジックによって直接呼び出されるものではないため、このしきい値には追跡されません。
タイプ CALL のアクティビティー。 CALL アクティビティーでは、プロシージャーのために追跡されるプロセッサー時間には、子アクティビティーまたは fenced モード・プロセスで使用されるプロセッサー時間は含まれません。このしきい値条件は、ユーザー・ロジックからデータベース・エンジンへの戻りでのみチェックされます。例えば、トラステッド・ルーチンの実行中にしきい値条件がチェックされるのは、そのルーチンがデータベース・エンジンに要求を発行するときのみです。

CHECKING EVERY 整数値 SECOND | SECONDS: アクティビティーのしきい値条件がチェックされる頻度を指定します。 CPUTIMEINSC しきい値の細分度は、この数値にアクティビティーの並列処理の度合いを乗算したものとほぼ等しくなります。例えば、しきい値が 60 秒ごとにチェックされ、並列処理の度合いが 2 である場合、アクティビティーが、しきい値違反が検出される前に、プロセッサー時間を 1 分ではなく、余分に 2 分使用することがあります。デフォルトは 60 秒です。この値には、86400 秒を上限として、任意の正整数 (ゼロ以外) を指定できます (SQLSTATE 42820)。低い値を設定すると、システム性能に悪影響を与える可能性があります。

この条件を使用して、データベース・マネージャーがアクティビティーに許可する実行時間の上限を定義できます。この時間には、アクティビティーが WLM 並行性しきい値によってキューに入れられた時間は含まれません。この条件の定義ドメインは、以下のしきい値のいずれかでなければなりません (SQLSTATE 5U037)。

データベース
サービス・スーパークラス
サービス・サブクラス
ステートメント
ワークロード
作業アクション ¹
1. 作業アクションの定義ドメインのしきい値は、CREATE WORK ACTION SET ステートメントまたは ALTER WORK ACTION SET ステートメントを使用して作成されます。作業アクション・セットは、ワークロードまたはデータベースに適用する必要があります。

適用範囲は DATABASE にする必要があります (SQLSTATE 5U037)。

指定する integer-value は、ゼロより大きい整数でなければなりません (SQLSTATE 42820)。有効な期間キーワードを使用して、integer-value に適切な時間の単位を指定してください。指定する時間単位が SECONDS の場合、値は 10 の倍数でなければなりません (SQLSTATE 42615)。このしきい値に指定できる最大値は 2 147 483 640 秒です。 DAY、HOUR、MINUTE、SECONDS 時間単位の値に最大値よりも長い秒に相当する値が指定された場合は、エラーが戻されます (SQLSTATE 42615)。

この条件を使用して、データベース・マネージャーがアクティビティーに許可する実行時間の上限を定義できます。この時間には、アクティビティーが WLM 並行性しきい値によってキューに入れられた時間は含まれません。このしきい値で追跡される実行時間は、アクティビティーの実行開始時刻から計測されます。

この条件の定義ドメインはサービス・サブクラス (UNDER 節を指定する SERVICE CLASS) でなければならず、強制の有効範囲は DATABASE にする必要があります (SQLSTATE 5U037)。

指定する integer-value は、ゼロより大きい整数でなければなりません (SQLSTATE 42820)。有効な期間キーワードを使用して、integer-value に適切な時間の単位を指定してください。指定する時間単位が SECONDS の場合、値は 10 の倍数でなければなりません (SQLSTATE 42615)。このしきい値に指定できる最大値は 2 147 483 640 秒です。 DAY、HOUR、MINUTE、SECONDS 時間単位の値に最大値よりも長い秒に相当する値が指定された場合は、エラーが戻されます (SQLSTATE 42615)。

SORTSHRHEAPUTIL > integer-value PERCENT

重要: このフィーチャーは、 Db2 バージョン 11.5 モディフィケーションパック 2 以降のバージョンで使用できます。

この条件は、照会で要求できる共有ソート・メモリーの最大値を、データベース共有ソート・メモリー合計 (sheapthres_shr) のパーセンテージとして定義します。アダプティブ・ワークロード・マネージャーが有効になっている場合、このしきい値では、照会の推定メモリー所要量と実際のメモリー所要量の両方が考慮されます。 1 から 100 の範囲の正整数をパーセント値として指定できます。このしきい値で追跡される実行時間は、アクティビティーの実行開始時刻から計測されます。

この条件の定義ドメインは DATABASE、作業アクション (作業アクション定義ドメインのしきい値は CREATE WORK ACTION SET または ALTER WORK ACTION SET ステートメントを使用して作成される。作業アクション・セットがワークロードまたはデータベースに適用されなければならない)、SERVICE SUPERCLASS、SERVICE SUBCLASS、STATEMENT、または WORKLOAD でなければならず、強制の有効範囲は MEMBER にする必要があります (SQLSTATE 5U037)。

この条件では、以下のアクティビティーが追跡されます。

データ操作言語 (DML) タイプのコーディネーター・アクティビティー。
ユーザー・ロジックから直接呼び出されるネストされた DML アクティビティー。

integer-value のアドミッションをブロックしています: ソート・メモリー所要量を超過した場合、違反しているアクティビティーの背後で作業が現在キューに入れられている場合、キューに入れられた作業がソート・メモリーでブロックしている場合、および WLM アドミッション制御が指定された時間内に要求を受け入れなかった場合にのみ、アクションを実行することを指定します。 WLM アドミッション・キューの中にある作業の場合、要求がアドミッション・キューの前に到達したときにのみ、この条件が評価されます。アドミッション制御によって要求が許可されるたびに、キュー時間がリセットされます。複数の要求がこのしきい値に違反している場合、このしきい値に違反していないものが見つかるか、最後の要求に到達するまで (他の要求が背後にない場合など)、カスケード式に処理されます。; このしきい値の最大値は、2147483640 秒です。 2147483640 秒よりも大きい秒に相当する値が指定された場合は、この秒数に設定されます。指定された時間の最小精度は 10 秒であるため、指定された値はすべてこの時間の精度の影響を受けます。値 0 は、BLOCKING ADMISSION FOR 節を指定しない状態に相当します。

DATATAGINSC IN integer-constant, )

この条件では、アクティビティーが影響を与える表スペースに対して指定されるデータ・タグ値を 1 つ以上定義します。表スペースまたはその基礎となるストレージ・グループ (該当する場合) のデータ・タグは、設定しないか、1 から 9 までの値に設定できます。アクティビティーが作用する表スペースにデータ・タグが (表スペース・レベルとストレージ・グループ・レベルのいずれでも) 設定されていない場合、このしきい値はそのアクティビティーには影響を及ぼしません。この条件の定義ドメインはサービス・サブクラス (UNDER 節を指定する SERVICE CLASS) でなければならず、強制の有効範囲は DATABASE PARTITION にする必要があります (SQLSTATE 5U037)。この条件は、各データベース・パーティションで個別に強制されます。

この条件では、以下のアクティビティーが追跡されます。

データ操作言語 (DML) タイプのコーディネーター・アクティビティー。
ユーザー・ロジックから直接呼び出されるネストされた DML アクティビティー。

内部 SQL によってデータベース・マネージャーから開始できる DML アクティビティーは、この条件によって追跡されません。

このしきい値は、スキャンが表でオープンされるとき、または表に対して挿入が実行されるときにのみ検査されます。スキャンがオープンされた後に表からデータをフェッチしても、しきい値に違反しません。

DATATAGINSC NOT IN 整数定数, )

この条件では、アクティビティーが影響を与える表スペースに対して指定されないデータ・タグ値を 1 つ以上定義します。表スペースまたはその基礎となるストレージ・グループ (該当する場合) のデータ・タグは、設定しないか、1 から 9 までの値に設定できます。アクティビティーが作用する表スペースにデータ・タグが (表スペース・レベルとストレージ・グループ・レベルのいずれでも) 設定されていない場合、このしきい値はそのアクティビティーには影響を及ぼしません。この条件の定義ドメインはサービス・サブクラス (UNDER 節を指定する SERVICE CLASS) でなければならず、強制の有効範囲は DATABASE PARTITION にする必要があります (SQLSTATE 5U037)。この条件は、各データベース・パーティションで個別に強制されます。

この条件では、以下のアクティビティーが追跡されます。

データ操作言語 (DML) タイプのコーディネーター・アクティビティー。
ユーザー・ロジックから直接呼び出されるネストされた DML アクティビティー。

内部 SQL によってデータベース・マネージャーから開始できる DML アクティビティーは、この条件によって追跡されません。

threshold-exceeded-actions

条件を超過したときに実行するアクションを指定します。条件を超過するたびに、しきい値違反イベント・モニターにイベントが記録されます (アクティブになっている場合)。

COLLECT ACTIVITY DATA

しきい値を超過した各アクティビティーに関するデータを、アクティビティー完了時に任意のアクティブなアクティビティー・イベント・モニターに送信するように指定します。デフォルトは COLLECT ACTIVITY DATA NONE です。 COLLECT ACTIVITY DATA が指定されている場合、デフォルトは WITHOUT DETAILS です。 COLLECT ACTIVITY DATA 設定は、以下のような非アクティビティーしきい値には適用されません: CONNECTIONIDLETIME、 TOTALDBPARTITIONCONNECTIONS、 TOTALSCPARTITIONCONNECTIONS、 CONCURRENTWORKLOADOCCURRENCES、 UOWTOTALTIME。

NONE

しきい値を超過する各アクティビティーについて、アクティビティー・データを収集しないことを指定します。

ON COORDINATOR MEMBER

アクティビティーのコーディネーター・メンバーでのみアクティビティー・データを収集することを指定します。

ON ALL MEMBERS

アクティビティーが処理されるすべてのメンバーでアクティビティー・データを収集することを指定します。リモートのメンバーでは、アクティビティーがこれらのメンバーに到着および到着すると、アクティビティーのレコードが複数回キャプチャーされることがあります。予測しきい値の場合、超過したしきい値に対して CONTINUE アクションも指定した場合にのみ、すべてのメンバーでアクティビティー情報が収集されます。リアクティブしきい値の場合、ON ALL MEMBERS 節は効果がなく、アクティビティー情報は常にコーディネーター・メンバーでのみ収集されます。予測しきい値と反応しきい値の両方について、アクティビティーの詳細、セクション情報、または値は、コーディネーター・メンバーでのみ収集されます。

WITHOUT DETAILS

この作業アクションが定義されている作業クラスに関連する各アクティビティーについてのデータを、アクティビティーの実行完了時に、任意のアクティブなアクティビティー・イベント・モニターに送信するように指定します。ステートメント、コンパイル環境、およびセクション環境のデータに関する詳細は送信されません。

WITH

DETAILS: 任意のアクティブなアクティビティーにステートメントおよびコンパイル環境のデータが含まれる場合、それを該当するアクティビティーのイベント・モニターへ送信することを指定します。セクションの環境データは送信されません。

SECTION: ステートメント、コンパイル環境、セクション環境データ、セクション actuals を、それらが含まれるアクティビティー用のアクティブなアクティビティー・イベント・モニターに送信することを指定します。 DETAILS は SECTION が指定されている場合、指定する必要があります。予測しきい値の場合、セクション actuals は、アクティビティー・データが収集されるすべてのメンバーで収集されます。リアクティブしきい値の場合、セクション actuals はコーディネーター・メンバーでのみ収集されます。
AND VALUES: 任意のアクティブなアクティビティーに入力データ値が含まれている場合、それを該当するアクティビティーのイベント・モニターに送信することを指定します。このデータには、REOPT ALWAYS BIND オプションを使用してコンパイルされた SQL ステートメントは含まれません。

STOP EXECUTION

アクティビティーの実行を停止し、エラーを戻します (SQLSTATE 5U026)。 UOWTOTALTIME しきい値の場合、作業単位はロールバックされます。

CONTINUE

アクティビティーの実行を停止しません。

FORCE APPLICATION

アプリケーションは強制的にシステムから切断されます (SQLSTATE 55032)。このアクションは、UOWTOTALTIME しきい値に対してのみ指定できます。

remap-activity-action

service-subclass-name への REMAP ACTIVITY: アクティビティーは service-subclass-name にマップされます。アクティビティーの実行を停止しません。このアクションは、CPUTIMEINSC しきい値、SQLROWSREADINSC しきい値、DATATAGINSC IN しきい値、DATATAGINSC NOT IN しきい値および ACTIVITYTOTALRUNTIMEINALLSC しきい値などの in-service-class および in-all-service-class しきい値でのみ有効です (SQLSTATE 5U037)。 service-subclass-name は、このしきい値に関連付けられている同じスーパークラスの下にある既存のサービス・サブクラスを識別する必要があります (SQLSTATE 5U037)。 service-subclass-name を、このしきい値に関連付けられているサービス・サブクラスと同じにすることはできません (SQLSTATE 5U037)。
NO EVENT MONITOR RECORD: しきい値違反レコードを書き込まないように指定します。
LOG EVENT MONITOR RECORD: THRESHOLD VIOLATIONS イベント・モニターが存在し、アクティブになっている場合には、しきい値違反レコードをそこに書き込むように指定します。

注

データベース動作のさまざまな側面にしきい値を定義して、その動作のモニターおよび制御を行うことができます。特に明記がない限り、アクティビティーにしきい値を定義すると、SQL ステートメントの実際の実行時 (コンパイル時を除く) およびロード・ユーティリティーの実行時にのみ、そのしきい値は適用されます。
CONCURRENTWORKLOADOCCURRENCES しきい値と CONCURRENTWORKLOADACTIVITIES しきい値とでは、有効範囲が異なります。 CONCURRENTWORKLOADOCCURRENCES は 1 つのワークロード定義に同時にマップできる接続の数を制御し、CONCURRENTWORKLOADACTIVITIES はワークロード定義にマップされた接続ごとに同時に実行できるアクティビティーの数を制御します。
変更はシステム・カタログに書き込まれますが、COMMIT ステートメントが実行されるまで有効になりません。これは、ステートメントを発行する接続の場合でも当てはまります。
全パーティションを通じて、同時に実行できる非コミットの WLM 排他 SQL ステートメントは 1 つのみです。非コミットの WLM 排他 SQL ステートメントが実行されている場合、後続の WLM 排他 SQL ステートメントは、現行の WLM 排他 SQL ステートメントがコミットまたはロールバックされるまで待機します。
しきい値超過アクション CONTINUE およびイベント・モニター・データ: しきい値条件を超過した場合、イベント・モニター・データはメンバーごとに 1 回のみ収集されます。しきい値超過アクションが CONTINUE の場合、アクティビティーは実行を継続し、影響を受けるメンバーでそのしきい値のイベント・モニター・データはそれ以上収集されません。例えば、10 分の時間しきい値にアクション CONTINUE が指定されているとします。アクティビティーが 10 分の上限を超えると、影響を受けるメンバーでしきい値のイベント・モニター・データが収集されます。
サービス・クラスの静止: 通常は静止できないサービス・クラス (例えば、デフォルト・ユーザー・クラスやデフォルト・システム・クラス) の静止をシミュレートするには、TOTALSCPARTITIONCONNECTIONS しきい値条件を使用できます。 SYSDEFAULTADMWORKLOAD で実行される DBADM 権限を持つユーザーにはしきい値が適用されない一方で、静止サービス・クラスはどのユーザーにも使用できないため、これは便利です。したがって、デフォルトのサービス・クラスは直接静止させることはできませんが、唯一、しきい値を使用して、DBADM 権限を持つユーザーが SYSDEFAULTADMWORKLOAD を使用してデータベースに接続する際にそれらを結合できるようにすることによってそれが可能になります。
代替構文: Db2 11.1 以前、および他のデータベース製品との互換性のために、以下のパラメーターがサポートされています。
アテンション:
- これらの代替は非標準であり、使用すべきではありません。
- DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数は、 Db2 pureScale 環境専用です。
- DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数が ON に設定されている場合を除き、DATABASE PARTITION を MEMBER の代わりに指定できます。
- DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数が ON に設定されている場合を除き、DATABASE PARTITIONS を MEMBERS の代わりに指定できます。
- DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数が ON に設定されている場合を除き、TOTALDBPARTITIONCONNECTIONS PARTITIONS を TOTALMEMBERCONNECTIONS の代わりに指定できます。
- DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数が ON に設定されている場合を除き、TOTALSCPARTITIONCONNECTIONS PARTITIONS を TOTALSCMEMBERCONNECTIONS の代わりに指定できます。

例

例 1: データベース内のすべてのアクティビティーに対して TEMPORARY 表スペースの最大使用量を 50M (データベース・パーティションごとに) に強制するしきい値を作成します。このしきい値に違反するアクティビティーはすべて停止させます。
```
   CREATE THRESHOLD DBMAX50MEGTEMPSPACE
     FOR DATABASE ACTIVITIES
     ENFORCEMENT MEMBER
     WHEN SQLTEMPSPACE > 50 M
     STOP EXECUTION
```
例 2: データベース内のすべてのアクティビティーのデフォルトの実行時間に最大 1 時間という制限を設ける、2 つ目のしきい値を作成します。このしきい値に違反するアクティビティーはすべて停止させます。
```
   CREATE THRESHOLD DBMAX1HOURRUNTIME
     FOR DATABASE
     WHEN ACTIVITYTOTALTIME > 1 HOUR
     STOP EXECUTION
```
例 3: 平均より多くの TEMPORARY スペースを使用し、実行時間が 1 時間を超える照会をホストするために BIGQUERIES という名前のサービス・スーパークラスが作成されたとします。このサービス・クラス内に定義したしきい値は、上の例で設定したデータベース・レベルの値をオーバーライドします。このスーパークラス内部のしきい値に違反するアクティビティーを引き続き実行させ、かつ詳しい分析のために詳細情報を収集する方法に注目してください。
```
   CREATE THRESHOLD BIGQUERIESMAX500MEGTEMPSPACE
     FOR SERVICE CLASS BIGQUERIES ACTIVITIES
     ENFORCEMENT DATABASE MEMBER
     WHEN SQLTEMPSPACE  > 500 M
     COLLECT ACTIVITY DATA WITH DETAILS AND VALUES
     CONTINUE

   CREATE THRESHOLD BIGQUERIESLONGRUNNINGTIME
     FOR SERVICE CLASS BIGQUERIES ACTIVITIES
     ENFORCEMENT DATABASE
     WHEN ACTIVITYTOTALTIME   > 10 HOURS
     COLLECT ACTIVITY DATA WITH DETAILS AND VALUES
     CONTINUE
```

例 4: PAYROLL という名前のワークロードが存在するとします。このワークロード内のアクティビティーの最大数が 10 以下にするしきい値を作成します。

   CREATE THRESHOLD MAXACTIVITIESINPAYROLL
     FOR WORKLOAD PAYROLL ACTIVITIES
     ENFORCEMENT WORKLOAD OCCURRENCE
     WHEN CONCURRENTWORKLOADACTIVITIES > 10
     STOP EXECUTION

例 5: サービス・クラス BIGQUERIES 内の並行するアクティビティーの最大数が 2 になるように強制するしきい値を作成します。

   CREATE THRESHOLD MAXBIGQUERIESCONCURRENCY
     FOR SERVICE CLASS BIGQUERIES  ACTIVITIES
     ENFORCEMENT DATABASE
     WHEN CONCURRENTDBCOORDACTIVITIES > 2
     STOP EXECUTION

例 6: 1 分間を超えて実行されている特定のステートメントのアクティビティー情報をキャプチャーするしきい値を作成しますが、ステートメントの実行は中止しません。

   CREATE THRESHOLD TH1 
     FOR STATEMENT 
     TEXT 'SELECT DISTINCT PARTS_BIN FROM STOCK WHERE PART_NUMBER = ?'
     ACTIVITIES ENFORCEMENT DATABASE   
     WHEN ACTIVITYTOTALTIME > 1 MINUTE   
     COLLECT ACTIVITY DATA WITH DETAILS, SECTION AND VALUES 
     CONTINUE

CREATE THRESHOLD ステートメント

呼び出し

許可

構文

説明

注

例