Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
指定した値にユーザー定義カウンターを設定します。
sa_user_defined_counter_set ( counter_name [, value [, apply_to_con [, appy_to_db [, apply_to_server ] ] ] ] )
counter_name 値を変更するユーザー定義カウンターの名前を指定する VARCHAR(128) パラメーター。ユーザー定義カウンター名の例としては、UserDefinedCounterRate01 や UserDefinedCounterRaw01 があります。
value ユーザー定義カウンターを変更する量。デフォルトは 1 です。
apply_to_con 現在の接続のカウンター値を調整するかどうかを指定する INT パラメーター。0 は値を調整しないことを意味し、1 は値を調整することを意味します。デフォルトは 1 です。
apply_to_db データベースのカウンター値を調整するかどうかを指定する INT パラメーター。0 は値を調整しないことを意味し、1 は値を調整することを意味します。デフォルトは 1 です。
apply_to_server データベースサーバーのカウンター値を調整するかどうかを指定する INT パラメーター。0 は値を調整しないことを意味し、1 は値を調整することを意味します。デフォルトは 1 です。
このプロシージャーは、value が定義された場合は 1 を返し、それ以外は 0 を返します。value が定義されない場合は 0 を返し、エラーが発生した場合はエラーコードを返します。次のようなエラーがあります。
カウンターへの同時アクセスは自動的に適用されるので、カウンター値は複数の同時要求によってリセットされる可能性があります。
DBA 権限。
なし。
次の文は、現在の接続、データベース、データベースサーバーの UserDefinedCounterRate01 の値を 0 に設定します。
SELECT dbo.sa_user_defined_counter_set( 'UserDefinedCounterRate01', 0, 1, 1, 1 );