Aracılığıyla paylaş

  • Makale

sp_trace_create (Transact-SQL)

İzlem tanımını oluşturur.Yeni izleme durdurulmuş durumda olacaktır.

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

Sözdizimi

sp_trace_create [ @traceid = ] trace_id OUTPUT 
          , [ @options = ] option_value 
          , [ @tracefile = ] 'trace_file' 
     [ , [ @maxfilesize = ] max_file_size ]
     [ , [ @stoptime = ] 'stop_time' ]
     [ , [ @filecount = ] 'max_rollover_files' ]

Bağımsız değişkenler

  • [ @traceid= ] trace_id
    Tarafından atanan sayısı Microsoft SQL Server Yeni bir izleme.Herhangi bir kullanıcı tarafından sağlanan giriş yoksayılacak.trace_idİş int, varsayılan değer null.Kullanıcı kullanan trace_id tanıtmak, değiştirmek ve bu saklı yordamtanımlı izleme denetlemek için değer.

  • [ @options= ] option_value
    Seçeneklerini küme için izleme belirtir.option_valueİş int, ile hiçbir varsayılan.Kullanıcılar, options çekilen toplam değeri belirterek bu seçeneklerin bir bileşimini seçebilirsiniz.Her iki seçenek üzerinde TRACE_FILE_ROLLOVER ve shutdown_on_error açmak için örneğin, belirtmek 6 için option_value.

    Aşağıdaki tablo seçenekleri, açıklamaları ve bunların değerlerini listeler.

    Seçenek adı

    Seçenek değeri

    Açıklama

    TRACE_FILE_ROLLOVER

    2

    O zaman belirtir max_file_size ulaşılırsa, geçerli izleme dosyası kapalı olduğu ve yeni bir dosya oluşturulur.Tüm yeni kayıtlarda yeni dosyaya yazılır.Yeni dosyayı önceki dosyayla aynı ada sahip, ancak kendi sırasını belirtmek için bir tamsayı eklenir.Örneğin, özgün izleme dosyası filename.trc ise, İleri izleme dosyası filename_1.trc olarak adlandırılır, aşağıdaki izleme dosyası filename_2.trc vb..

    Daha fazla rollover izleme dosyaları oluşturulur, dosya adı artar ardışık olarak eklenmiş tamsayı değeri.

    SQL Sunucunun kullandığı varsayılan değer olan max_file_size (5 mb) ise bu seçenek için bir değer belirtmeden belirtilen max_file_size.

    SHUTDOWN_ON_ERROR

    4

    İzleme için herhangi bir nedenle dosyasına yazılamıyor, SQL Server kapatır belirtir kapalı.Bu seçenek, güvenlik denetim izlemeleri gerçekleştirirken kullanışlıdır.

    TRACE_PRODUCE_BLACKBOX

    8

    Sunucu tarafından izleme bilgileri sunucu tarafından üretilen 5 mb son kaydını kaydedileceğini belirtir.trace_produce_blackbox diğer seçenekleri ile uyumlu değil.

  • [ @tracefile= ] 'trace_file'
    İzleme yazılacağı dosya adını ve konumunu belirtir.trace_fileİş nvarchar(245)ile hiçbir varsayılan.trace_file(örneğin, n 'C:\MSSQL\Trace\trace.trc'), yerel bir dizin veya bir unc paylaşımına veya yol olabilir (n'\\sunucuadı\PaylaşımAdı\dizini\trace.trc').

    SQL Serverekleyeceği bir .trc tüm izleme dosyası adı uzantısı.TRACE_FILE_ROLLOVER seçeneği ve bir max_file_size belirtilmiş, SQL Server oluşturur Yeni bir izleme dosyası , özgün izleme dosyası büyüyerek en fazla kendi boyutu.Yeni dosyayı özgün dosya ancak _ aynı ada sahipn başlayarak, kendi sırasını belirtmek için eklenen 1.Örneğin ilk izleme dosyası , filename.trc, ikinci bir izleme dosyası adlı filename_1.trc.

    TRACE_FILE_ROLLOVER seçeneğini kullanırsanız, özgün izleme dosyası adında alt çizgi karakterleri kullanmayın öneririz.Alt çizgi kullanırsanız, aşağıdaki davranış oluşur:

    • SQL Server Profilerotomatik yük vermez veya (Bu dosyayı başa döndürme seçeneği yapılandırılmışsa) rollover dosyaları yüklemek isteyip istemediğinizi soracak.

    • fn_trace_gettableişlev rollover dosyaları yüklenmiyor (kullanılarak belirtildiğinde number_files bağımsız değişkeni) özgün dosya adını sona ereceği alt çizgi ile sayısal bir değer.(Bu alt çizgi ve bir dosya geldiğinde otomatik olarak eklenir numarası geçerli değildir.)

    Not

    Her ikisi bu davranışlar için bir çözüm olarak dosyaları özgün dosya adında alt çizgi kaldırmak için adını değiştirebilirsiniz.Örneğin, özgün dosya adında, my_trace.trc, ve başa dönen dosya adı my_trace_1.trc, dosyaları yeniden adlandırabilirsiniz mytrace.trc ve mytrace_1.trc dosyaları açmadan önce SQL Server Profiler.

    trace_filetrace_produce_blackbox seçeneği kullanıldığında belirtilemez.

  • [ @maxfilesize= ] max_file_size
    Megabayt (mb) bir izleme dosyası en büyük boyutu büyüyebilir belirtir.max_file_sizeİş bigint, varsayılan değeri 5.

    Bu parametre TRACE_FILE_ROLLOVER seçeneği belirtilirse, kullanılan disk alanı belirtilen tutarı aşarsa izleme dosyasının kaydı durdurur max_file_size.

  • [ @stoptime= ] 'stop_time'
    tarih ve saat izleme durduruldu belirtir.stop_timeİş datetime, varsayılan değer null.null, izlemeyi elle durduruluncaya kadar veya sunucu shuts kapalıkadar çalışır.

    Her iki stop_time ve max_file_size belirtilir, ve TRACE_FILE_ROLLOVER belirtilen bitiş saat veya maksimum dosya boyutuna ulaşıldığında belirtilen izleme üste.stop_time, max_file_sizeVe TRACE_FILE_ROLLOVER belirtilirse, belirtilen Dur saatizleme değil doldurun sürücü. varsayarak, izlemeyi durdurur

  • [ @filecount= ] 'max_rollover_files'
    Aynı temel dosya adı ile devam etmesine en fazla sayı veya izleme dosyaları belirtir.max_rollover_filesİş int, birden büyük.Bu parametre yalnızca TRACE_FILE_ROLLOVER seçenek belirtilmezse geçerli değil.Zaman max_rollover_files belirlendiğinde, SQL Server no korumaya çalışır birden fazla max_rollover_files eski izleme dosyası silerek yeni bir izleme dosyasıaçmadan önce dosya izleme.SQL Servertemel dosya adına bir numara ekleyerek yaşını izleme dosyaları izler.

    Örneğin, ne zaman trace_file parametresi "c:\mytrace", "c:\mytrace_123.trc" adı ile bir dosya olarak belirtilen bir dosya adı "c:\mytrace_124.trc"'den daha eski olduğunda.max_rollover_files "C:\mytrace_123.trc" dosyası olan küme 2, sonra SQL Server siler izleme dosyası "c:\mytrace_125.trc" oluşturmadan önce.

    Dikkat SQL Server yalnızca bir kere her dosyayı silmek çalışır ve dosya bir başka işlem yüzünden kullanımda olduğundan silinemiyorBu nedenle, başka bir uygulama izleme dosyalarla çalışıyorsanız, izleme işleminin çalıştığını, SQL Server bırakılmasına neden olabilir bu izleme dosyalarının dosya sistemi.

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.

10

Geçersiz seçenek.Belirtilen seçenekler uyumsuz olduğunda döndürdü.

12

Dosya oluşturulamadı.

13

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

14

Geçersiz bitiş saat.Belirtilen durma saat zaten gerçekleşip döndürdü.

15

Geçersiz parametreler.Kullanıcı tarafından sağlanan uyumsuz parametreleri döndürdü.

Açıklamalar

sp_trace_create olan bir SQL Server saklı yordam önceden yürütülen eylemlerin çoğunu gerçekleştiren xp_trace_ * genişletilmiş saklı yordamlar SQL Server'ın önceki sürümlerinde kullanılabilir.Use sp_trace_create yerine:

  • xp_trace_addnewqueue

  • xp_trace_setqueuecreateinfo

  • xp_trace_setqueuedestination

sp_trace_create yalnızca izleme tanımını oluşturur.Bu saklı yordam başlatmak veya bir izleme değiştirmek için kullanılamaz.

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.

İçin sp_trace_create, SQL Serveryazma iznihizmet hesabı olması gerekir izleme dosyası klasörüne gidin.SQL Serverhizmet hesabı yönetici değil izleme dosyası bulunduğu bilgisayarda açıkça yazma izni vermeniz gerekir SQL Serverhizmet hesabı.

Not

Otomatik olarak oluşturulan izleme dosyası yükleyebilir sp_trace_create kullanarak bir tablo fn_trace_gettable sistem işlev.Bu sistem işlevkullanma hakkında daha fazla bilgi için bkz: fn_trace_gettable (Transact-SQL).

İzleme saklı yordamları kullanarak bir örnek için bkz: Nasıl yapılır: Bir izleme (Transact-SQL) oluştur.

trace_produce_blackbox aşağıdaki özelliklere sahiptir:

  • Bir rollover izleme var.Varsayılan file_count 2, ancak kullanıcı kullanarak geçersiz kılınabilir filecount seçeneği.

  • Varsayılan file_size dier izlemeler ile 5 MB'dir ve değiştirilebilir.

  • Dosya adı belirtilebilir.Dosya olarak kaydedilir: N'%SQLDIR%\MSSQL\DATA\blackbox.trc'

  • Yalnızca aşağıdaki olaylar ve bunların sütunlarını izlemesinde yer almaktadır:

    • rpc başlatma

    • Toplu iş başlangıç

    • Özel durum

    • Dikkat

  • Olayları veya sütun eklenemez veya bu izleme kaldırıldı.

  • Bu izleme için filtreleri belirtilemez.

İzinler

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