Aracılığıyla paylaş

  • Makale

sp_trace_setfilter (Transact-SQL)

İzleme için bir süzgeç uygular.sp_trace_setfilter durdurulan yalnızca varolan izlemeler için yürütülebilecek (status olan 0).SQL ServerBu saklı yordam , var olmayan bir izlemeyi veya whose yürütülür, bir hata döndürür status değil 0.

Konu bağlantısı simgesiTransact-SQL sözdizimi kuralları

Sözdizimi

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
    kümeizleme kimliğidir.trace_idİş int, ile hiçbir varsayılan.Kullanıcı bu kullanan trace_id değerine değiştirilir ve kontrol izleme.

  • [ @columnid= ] column_id
    Filtre uygulanan sütun kimliğidir.column_idİş int, ile hiçbir varsayılan.column_id , null, SQL Server temizler tüm filtreleri için belirtilen izleme.

  • [ @ logical_operator =] logical_operator
    Belirtir olup olmadığını ve (0) veya or (1) işleç uygulanır.logical_operatorİş int, ile hiçbir varsayılan.

  • [ @ comparison_operator= ] comparison_operator
    Yapılması için karşılaştırma türünü belirtir.comparison_operatorİş int, ile hiçbir varsayılan.tablo karşılaştırma işleçleri ve temsilcisi değerlerini içerir.

    Değer

    Karşılaştırma işleci

    0

    = (Eşittir)

    1

    <>(Eşit değil)

    2

    >(Büyüktür)

    3

    <(Küçüktür)

    4

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

    5

    <(Küçük veya eşit) =

    6

    GİBİ

    7

    BENZER DEĞİL

  • [ @value= ] value
    Filtre uygulanacak değeri belirtir.Veri türü value Süzülecek sütun veri türü ile eşleşmelidir.Örneğin, filtre küme olan bir nesne kimliği sütun ise bir int veri türü value olması int.value Olan nvarchar veya varbinary, 8000 en çok uzunluğunu olabilir.

    Karşılaştırma işleç gibi veya mantıksal işleç "%" olmaması gibi olduğunda veya diğer filtre LIKE işlem için uygun.

    İçinde SQL Server 2005 ve daha sonra belirtebilirsiniz için null value olaylarıyla süzmenull sütun değerleri.Yalnızca 0 (eşittir (=) ve 1 (<> eşit değildir) işleçleri null ile geçerli.Bu durumda, bu operatörler eşdeğer Transact-SQL IS null ve IS not null operators.

    sütun değerlerini aralık arasında filtre uygulamak için sp_trace_setfilter iki kez--bir kez bir büyük-daha-veya-eşittir ile yürütülmelidir ('>=') karşılaştırma işleçve bir daha az-daha-veya-eşittir ile başka bir saat ('<=') işleç.

    Verileri 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ın saklı yordamişleminin tamamlanmasının ardından almak kodu değerleri açıklar.

Dönüş kodu

Açıklama

0

Hata yok.

1

Bilinmeyen hata.

2

İzleme şu an çalışıyor.Bir hata bu saat sonuçlar izlemesine 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önen sp_trace_setfilter.

6

Belirtilen karşılaştırma işleci geçerli değil.

7

Belirtilen mantıksal işleci geçerli değil.

9

Belirtilen izleme tutamacını geçerli değil.

13

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

16

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

Açıklamalar

sp_trace_setfilter olan bir SQL Server saklı yordam önceden önceki sürümlerinde kullanılabilen genişletilmiş saklı yordamlar tarafından yürütülen eylemlerin çoğunu gerçekleştiren SQL Server.Use sp_trace_setfilter yerine xp_trace_set * filtre oluşturmak için saklı yordamlar genişletilmiş, uygulamak, kaldırmak veya izlemeler filtreler yönetmek.Daha fazla bilgi için, bkz. Bir izleme süzme.

Belirli bir sütun için tüm filtreleri birlikte bir yürütülmesi etkinleştirilmelidir sp_trace_setfilter.İki filtre uygulama adı sütun ve sütunkullanıcıadı bir filtre uygulamak bir kullanıcı çalışırsa, örneğin, kullanıcı filtreleri uygulama adı üzerinde sırayla belirtmeniz gerekir.SQL Serverbir saklı yordam çağrısındaki uygulama adı üzerinde bir filtre belirtmek kullanıcı çalışırsa hata username, sonra başka bir filtre uygulama adı üzerinde bir filtre tarafından takip verir.

Tüm SQL izleme parametrelerini saklı yordamlar (sp_trace_xx) kesinlikle yazılı.Bu parametreler bağımsız açıklamasında belirtildiği gibi doğru giriş parametresi veri türleriyle adlandırılırlar değil, saklı yordam bir hata döndürür.

İzinler

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

Örnekler

Aşağıdaki örnek, izleme üzerinde üç filtreler ayarlar 1.Filtreleri N'SQLT%' ve N'MS%' bir sütun üzerinde çalışması (AppName, değer 10) kullanarak "LIKE"" Karşılaştırma işleç.Filtre N'joe' üzerinde farklı bir sütun çalışır (UserName, değer 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'