sp_trace_generateevent (Transact-sql)

Makale
12/11/2012

Kullanıcı tanımlı olay oluşturur.

[!NOT]

Bu saklı yordam kullanım değil. Tüm diğer izleme ile ilgili saklı yordamlar onaylanmaz.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

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

Bağımsız değişkenler

**@eventid=**event_id
Açmak için olayın kimliğidir. event_idise int, hiçbir varsayılan ile. ID 82 91 ile belirlenen kullanıcı tanımlı olaylarını temsil yoluyla olay numaralardan biri olmalıdır sp_trace_setevent.
@userinfo= ] 'user_info'
Kullanıcı tarafından tanımlanan isteğe bağlı dize olayın nedeni tespit olduğunu. user_infoise nvarchar(128), null varsayılan.
@userdata= ] user_data
İsteğe bağlı kullanıcı belirtilen olay için veridir. user_dataise varbinary(8000), null varsayılan.

Dönüş Kodu Değerleri

Aşağıdaki tabloda, kullanıcılar saklı yordamın tamamlanması sonrasında almak kodu değerleri açıklar.

Dönüş kodu	Açıklama
0	Herhangi bir hata.
1	Bilinmeyen bir hata oluştu.
3	Belirtilen olay geçerli değil. Olay varolmayabilir veya deposu yordamı için uygun bir değil.
13	Bellek yetersiz. Belirtilen eylemi gerçekleştirmek için yeterli bellek olmadığında döndü.

Açıklamalar

sp_trace_generateevent olan bir Microsoft SQL Server 2000saklı yordam, önceden tarafından yürütülen eylemlerin çoğunu gerçekleştiren xp_trace_ * genişletilmiş saklı yordamlar önceki sürümlerinde kullanılabilen SQL Server. Kullanım sp_trace_generateevent yerine xp_trace_generate_event.

Yalnızca kullanıcı tanımlı olay kimlik numaraları ile kullanılabilir sp_trace_generateevent. SQL Serverdiğer olay kimliği numaraları kullanılıyorsa bir hata yükseltmek.

Tüm sql izleme parametrelerini depolanan yordamlar (sp_trace_xx) kesinlikle yazılmalıdır. Bu parametreler doğru giriş parametresi veri türlerinde, değişken açıklaması'nda belirtilen denir değil saklı yordamı bir hata döndürür.

İzinler

Kullanıcı alter trace izni olmalıdır.

Örnekler

Aşağıdaki örnek, bir kullanıcı tarafından yapılandırılabilen olay örnek tablo oluşturur.

--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');