sp_trace_generateevent (Transact-SQL)

  • [アーティクル]

ユーザー定義イベントを作成します。

注意注

このストアド プロシージャは非推奨ではありません。 他のすべてのトレース関連のストアド プロシージャの使用は推奨されません。

トピック リンク アイコン Transact-SQL 構文表記規則

構文

sp_trace_generateevent [ @eventid = ] event_id 
     [ , [ @userinfo = ] 'user_info' ]
     [ , [ @userdata = ] user_data ]

引数

  • [ @eventid=] event_id
    有効にするイベントの ID を指定します。 event_id のデータ型は int で、既定値はありません。 この ID には、82 ～ 91 のイベント番号を指定する必要があります。この番号は、sp_trace_setevent で設定されるユーザー定義のイベントを表します。

  • [ @userinfo= ] 'user_info'
    イベントの理由を示すユーザー定義の文字列を指定します。この引数は省略可能です。 user_info のデータ型は nvarchar(128) で、既定値は NULL です。

  • [ @userdata= ] user_data
    イベントに対するユーザー指定のデータを指定します。この引数は省略可能です。 user_data のデータ型は varbinary(8000) で、既定値は NULL です。

戻り値

次の表は、このストアド プロシージャの完了時に返されるコード値を示しています。

リターン コード

説明

0

エラーはありません。

1

不明なエラーです。

3

指定したイベントは無効です。 イベントが存在しないか、イベントがこのストアド プロシージャに対して適切ではありません。

13

メモリが不足しています。 指定した操作を実行するための十分なメモリがない場合に返されます。

説明

sp_trace_generateevent は Microsoft SQL Server 2000 のストアド プロシージャです。以前のバージョンの SQL Server で、拡張ストアド プロシージャ xp_trace_* を使って実行していた操作の多くは、このストアド プロシージャで実行できます。 xp_trace_generate_event の代わりに sp_trace_generateevent を使用してください。

sp_trace_generateevent には、ユーザー定義イベントの ID 番号のみを使用できます。 SQL Server で他のイベント ID 番号を使用すると、エラーが発生します。

すべての SQL トレース ストアド プロシージャ (sp_trace_xx) のパラメーターでは、データ型が厳密に定義されています。 これらのパラメーターを、引数の説明で指定されている正しいデータ型で指定しないと、このストアド プロシージャはエラーを返します。

権限

ユーザーに ALTER TRACE 権限が必要です。

使用例

次の例では、ユーザーが構成できるイベントをサンプル テーブルに作成します。

--Create a sample table.
CREATE TABLE user_config_test(col1 int, col2 char(10));

--DROP the trigger if it already exists.
IF EXISTS
   (SELECT * FROM sysobjects WHERE name = 'userconfig_trg')
   DROP TRIGGER userconfig_trg;

--Create an ON INSERT trigger on the sample table.
CREATE TRIGGER userconfig_trg
   ON user_config_test FOR INSERT;
AS
EXEC master..sp_trace_generateevent
   @event_class = 82, @userinfo = N'Inserted row into user_config_test';

--When an insert action happens, the user-configurable event fires. If 
you were capturing the event id=82, you will see it in the Profiler output.
INSERT INTO user_config_test VALUES(1, 'abc');

関連項目

参照

sys.fn_trace_geteventinfo (Transact-SQL)

sp_trace_setevent (Transact-SQL)

概念

SQL トレース