sa_user_defined_counter_add システムプロシージャー

sa_user_defined_counter_add ( counter_name 
[, delta
[, apply_to_con
[, appy_to_db
[, apply_to_server ] ] ] ]
)

counter_name 値を変更するユーザー定義カウンターの名前を指定する VARCHAR(128) パラメーター。ユーザー定義カウンター名の例としては、UserDefinedCounterRate01 や UserDefinedCounterRaw01 があります。
delta ユーザー定義カウンターを増分または減分する量。デフォルトは 1 です。
apply_to_con 現在の接続のカウンター値を調整するかどうかを指定する INT パラメーター。0 は値を調整しないことを意味し、1 は値を調整することを意味します。デフォルトは 1 です。
apply_to_db データベースのカウンター値を調整するかどうかを指定する INT パラメーター。0 は値を調整しないことを意味し、1 は値を調整することを意味します。デフォルトは 1 です。
apply_to_server データベースサーバーのカウンター値を調整するかどうかを指定する INT パラメーター。0 は値を調整しないことを意味し、1 は値を調整することを意味します。デフォルトは 1 です。

このプロシージャーは、delta が定義された場合は 1 を返し、それ以外は 0 を返します。delta が定義されない場合は 0 を返し、エラーが発生した場合はエラーコードを返します。次のようなエラーがあります。

カウンターへの同時アクセスは自動的に適用されるので、カウンター値は複数の同時要求によって増分される可能性があります。

DBA 権限。

なし。

次の文は、現在の接続、データベース、データベースサーバーの UserDefinedCounterRate01 の値を 0 に変更します。

SELECT dbo.sa_user_defined_counter_set( 'UserDefinedCounterRate01', 0, 1, 1, 1 );