Aracılığıyla paylaş

  • Makale

sp_trace_setfilter (Transact-SQL)

Applies a filter to a trace.sp_trace_setfilter may be executed only on existing traces that are stopped (status is 0).SQL Server returns an error if this stored procedure is executed on a trace that does not exist or whose status is not 0.

Topic link iconTransact-SQL sözdizimi kuralları

sp_trace_setfilter [ @traceid = ] trace_id 
          , [ @columnid = ] column_id
          , [ @logical_operator = ] logical_operator
          , [ @comparison_operator = ] comparison_operator
          , [ @value = ] value

Bağımsız değişkenler

  • [ @traceid= ] trace_id
    Is the ID of the trace to which the filter is set.trace_id is int, with no default.Kullanıcı bu kullanır. trace_id tanımlamak için değiştirmek ve izleme denetlemek için değer'ı tıklatın.

  • [ @columnid= ] column_id
    Is the ID of the column on which the filter is applied.column_id is int, with no default.If column_id null, SQL Server Belirtilen izleme için tüm filtreleri kaldırır.

  • [ @ logical_operator = ] logical_operator
    Specifies whether the AND (0) or OR (1) operator is applied.logical_operator is int, with no default.

  • [ @comparison_operator= ] comparison_operator
    Specifies the type of comparison to be made.comparison_operator is int, with no default.Bu tablo, karşılaştırma işleçlerini ve temsili değerlerini içerir.

    Değer

    Karşılaştırma işleci

    0

    (Eşittir) =

    1

    <> (Eşit değil)

    2

    > (Büyük)

    3

    < (Küçüktür)

    4

    >= (Büyüktür veya eşittir)

    5

    <(Küçük veya eşittir tarihi) =

    6

    BENZER

    7

    BENZER DEĞİL

  • [ @value= ] value
    Süzmek istediğiniz değeri belirtir.Veri türü value Süzülecek sütun veri türü ile eşleşmelidir. Süzgeç, örneğin küme olan bir nesne KIMLIĞI sütunnda bir int veri türü value olmalıdır int. If value olan nvarchar veya varbinary, 8000 en büyük bir uzunluğa sahip olabilir.

    Karşılaştırma işleç LIKE veya "%" veya diğer süzgeç LIKE işleme uygun mantıksal işleç ekleyebilirsiniz NOT LIKE olduğunda.

    Içinde SQL Server 2005 ve daha sonra NULL için belirtebilirsiniz. value Boş sütun değerlerine sahip olayların filtre için . Yalnızca 0 (Eşittir (=) ve 1 (<> Değil eşit) işleçleri NULL ile geçerlidir. Bu durumda, bu işleçler eşdeğer Transact-SQL IS NULL ve IS NOT NULL işleçler.

    Arasındaki aralık sütun, filtre uygulamak için sp_trace_setfilter bir büyük-göre-veya-eşittir ile iki kez--bir kez yürütülmelidir (' > = ') karşılaştırma işlecini ve bir daha az-göre-veya-eşittir ile başka bir saat (' < = ') işleç.

    Sütun veri türleri hakkında daha fazla bilgi için bkz: SQL Server olay sınıfı başvurusu.

Dönüş Kodu Değerleri

Aşağıdaki tablo kullanıcılar saklı yordam bitimini aşağıdaki alma kodu değerleri açıklar.

Dönüş kodu

Açıklama

0

Hata oluştu.

1

Bilinmeyen hata.

2

Izleme şu an çalışıyor.Izleme sırasında bir hata bu saat sonuçlarında değiştiriliyor.

4

Belirtilen sütun geçerli değil.

5

Belirtilen sütun, filtre uygulamak için izin verilmez.Bu değer yalnızca döndürdü sp_trace_setfilter.

6

Belirtilen karşılaştırma işleç geçersiz.

7

Belirtilen mantıksal işleç geçersiz.

9

Izleme Belirtilen tanıtıcı geçerli değil.

13

Bellek yetersiz.Belirtilen eylem gerçekleştirmek için yeterli bellek olmadığında döndürdü.

16

Işlev, bu izleme için geçerli değil.

Remarks

sp_trace_setfilter is a SQL Server birçok'ün önceki sürümlerinde kullanılabilen genişletilmiş saklı yordamlar tarafından daha önce gerçekleştirilen eylemleri gerçekleştiren bir saklı yordam SQL Server. Kullanımı sp_trace_setfilter yerinexp_trace_set * süzgeci oluşturmak, uygulama, kaldırmak veya izlemeler süzgeçlerini işlemek için saklı yordamlar genişletildi.Daha fazla bilgi için bkz:Bir izleme süzme.

Belirli bir sütun için tüm süzgeçleri birlikte bir yürütme etkinleştirilmiş olması gerekir sp_trace_setfilter.For example, if a user intends to apply two filters on the application name column and one filter on the username column, the user must specify the filters on application name in sequence.SQL Server returns an error if the user attempts to specify a filter on application name in one stored procedure call, followed by a filter on username, then another filter on application name.

Tüm SQL izleme parametrelerini yordamlar () depolanır.sp_trace_xx) kesinlikle girilir.Belirtilen bağımsız değişken açıklamasında doğru giriş parametresi veri türleriyle bu parametreler denir, saklı yordam hata verir.

İzinler

Kullanıcı, ALTER IZLEME izninizin olması gerekir.

Örnekler

Aşağıdaki örnek, üç süzgeci üzerinde izleme ayarlar 1. Süzgeçleri N'SQLT%' ve N'MS%' bir sütun (üzerinde çalışır.AppName, değeri 10) kullanarak "LIKE"karşılaştırma işleç. Süzgeç N'joe' bir başka sütun (üzerinde çalışır.UserName, değeri 11) kullanarak "EQUAL"karşılaştırma işleç.

sp_trace_setfilter  1, 10, 0, 6, N'SQLT%'
sp_trace_setfilter  1, 10, 0, 6, N'MS%'
sp_trace_setfilter  1, 11, 0, 0, N'joe'