Aracılığıyla paylaş

  • Makale

sp_trace_create (Transact-SQL)

Bir izleme tanımını oluşturur.Yeni izleme, durdurulmuş bir durumda olacaktır.

Topic link iconTransact-SQL sözdizimi kuralları

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
    Is the number assigned by Microsoft SQL Server to the new trace.Any user-provided input will be ignored.trace_id is int, with a default of NULL.Kullanıcı kullanan trace_id tanımlamak için değiştirmek ve bu saklı yordam tarafından tanımlanan izleme denetlemek için değer'ı tıklatın.

  • [ @options= ] option_value
    Specifies the options set for the trace.option_value is int, with no default.Kullanıcılar, bu seçeneklerin bir bileşimi Çekildi seçenekleri Toplam değerini belirleyerek seçebilirsiniz.Örneğin, her iki seçenekleri TRACE_FILE_ROLLOVER ve SHUTDOWN_ON_ERROR kapatmak için , belirtin. 6 for option_value.

    Aşağıdaki tabloda, 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şıldığında, geçerli izleme dosyası kapatıldı ve yeni bir dosya oluşturulur. Tüm yeni kayıtlar, yeni bir dosyaya yazılır.Yeni bir dosya önceki dosya aynı ada sahip, ancak kendi sırasını belirtmek için bir tamsayı eklenir.Örneğin, özgün izleme dosyası filename.trc olarak adlandırılmışsa, sonraki izleme dosyası filename_1.trc adlı, aşağıdaki izleme dosyası filename_2.trc vb..

    Için dosya adı artar sırayla eklenen Tamsayı değeri olarak daha fazla çevirme izleme dosyaları oluşturulur.

    SQL Server varsayılan değerini kullanır. max_file_size (Bu seçenek için değer belirtmeden belirtilmişse, 5 MB) max_file_size.

    shutdown_on_error

    4

    Izleme için herhangi bir nedenle dosyaya yazılamıyor, SQL Server kapandığını belirtir.Bu seçenek, güvenlik denetim izlemeler yerine getirirken yararlıdır.

    trace_produce_blackbox

    8

    Sunucu tarafından sunucu tarafından üretilen izleme bilgilerini 5 MB kaydını son kaydedileceğini belirtir.Diğer seçeneklerle TRACE_PRODUCE_BLACKBOX uyumsuz.

  • [ @tracefile= ] 'trace_file'
    Specifies the location and file name to which the trace will be written.trace_file is nvarchar(245) with no default.trace_file can be either a local directory (such as N 'C:\MSSQL\Trace\trace.trc') or a UNC to a share or path (N'\\Servername\Sharename\Directory\trace.trc').

    SQL Server ekleyeceği bir trc uzantısı tüm izleme dosyası adları.TRACE_FILE_ROLLOVER seçeneği ve bir max_file_size , belirtilmedi SQL Server özgün izleme dosyasının en büyük boyutuna büyüklüğü aştığında, yeni bir izleme dosyası oluşturur. Yeni bir dosya _ ancak özgün dosyayla aynı ada sahiptir...n ile başlayarak, kendi sırasını belirtmek için eklenir1.Örneğin, ilk izleme dosya yeniden adlandırılmışsa filename.trc ikinci izleme dosyası adıfilename_1.trc.

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

    • SQL Server Profiler otomatik olarak yükleme yapar veya (Bu dosyayı başa döndürme seçeneklerinden birini yapılandırılırsa) aktarma dosyaları yüklemek isteyip istemediğinizi soracak.

    • Fn_trace_gettable işlev aktarma dosyaları yüklenemedi (kullanılarak belirtildiğinde number_files bağımsız değişkeni) özgün dosya adına alt çizgi ve sayısal bir değer ile sona ereceği. (Bu sayı, bir dosyanın geldiğinde, otomatik olarak eklenir ve alt çizgi uygulanmaz.)

    Not

    Geçici bir çözüm olarak aşağıdaki davranışlardan biri her ikisi için özgün dosya adının altçizgiler kaldırmak için bu dosyaları yeniden adlandırabilirsiniz.Örneğin, özgün dosya yeniden adlandırılmışsa my_trace.trcbaşa dönen dosya ve adlımy_trace_1.trc için dosyaların adını değiştirebilirsinizmytrace.trc and mytrace_1.trc dosyaları açmadan önce SQL Server Profiler.

    trace_file TRACE_PRODUCE_BLACKBOX seçeneği kullanıldığında belirtilemez.

  • [ @maxfilesize= ] max_file_size
    Specifies the maximum size in megabytes (MB) a trace file can grow.max_file_size is bigint, with a default value of 5.

    Bu parametre TRACE_FILE_ROLLOVER seçeneği belirtilmişse, kullanılan disk alanı belirtilen tutarı aşarsa izleme dosyasına kayıt durdurur... max_file_size.

  • [ @stoptime= ] 'stop_time'
    Specifies the date and time the trace will be stopped.stop_time is datetime, with a default of NULL.null ise, izleme, el ile durduruluncaya kadar veya sunucu kapandığı kadar çalışır.

    Her iki, stop_time ve max_file_size Belirtilen, ve TRACE_FILE_ROLLOVER belirtilen bitiş saat veya en büyük dosya boyutuna ulaşıldığında, belirtilen tops izleme. If stop_time, max_file_sizeve TRACE_FILE_ROLLOVER belirtilmedi, bu izleme, izleme sürücüsünü kurarken doldurma varsayarak belirtilen durma saat durdurur.

  • [ @filecount= ] 'max_rollover_files'
    Specifies the maximum number or trace files to be maintained with the same base filename.max_rollover_files is int, greater than one.Bu parametre, yalnızca TRACE_FILE_ROLLOVER seçeneği belirtilirse geçerlidir.When max_rollover_files is specified, SQL Server tries to maintain no more than max_rollover_files trace files by deleting the oldest trace file before opening a new trace file.SQL Server tracks the age of trace files by appending a number to the base file name.

    Örneğin, ne zaman trace_file"c:\mytrace" parametresinde, bir dosya adı "c:\mytrace_123.trc" daha eski bir dosya adı "c:\mytrace_124.trc". If max_rollover_filessonra "c:\mytrace_125.trc" izleme dosyasını oluşturmadan önce SQL Server "c:\mytrace_123.trc" dosya siler, 2'ye küme.

    Dikkat SQL Server yalnızca deneme her silmek için dosya bir kez ve başka bir işlem tarafından kullanılmakta olan bir dosyayı silemiyor. Başka bir uygulama sırasında izleme dosyalarla çalışıyorsanız, bu nedenle, izleme, çalışan SQL Server Bu izleme dosyaları, dosya sisteminde bırakabilir.

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.

10

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

12

Dosya oluşturulamadı.

13

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

14

Geçersiz bitiş saat.Belirtilen bitiş saat zaten oluştu, döndürdü.

15

Geçersiz parametre.Kullanıcı uyumsuz parametreleri sağlandığında döndürdü.

Remarks

sp_trace_create is a SQL Server çoğu tarafından daha önce gerçekleştirilen eylemleri gerçekleştiren bir saklı yordam xp_trace_ * saklı yordamlar SQL Server'ın önceki sürümlerinde kullanılabilen genişletilmiş.Kullanımı sp_trace_create yerine:

  • xp_trace_addnewqueue

  • xp_trace_setqueuecreateinfo

  • xp_trace_setqueuedestination

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

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ı bir hata döndürecektir.

Için sp_trace_create, the SQL Server Hizmet hesabı, izleme dosyası üzerinde yazma izninizin olması gerekir. If the SQL Server hizmet account is not an administrator on the computer where the izleme dosyası is located, you must explicitly grant Write permission to the SQL Server hizmet account.

Not

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

Izleme, depolanan yordamları kullanarak örnek için bkz: Nasıl Yapılır: Bir izleme (Transact-SQL) oluşturma.

trace_produce_blackbox aşağıdaki özelliklere sahiptir:

  • Bu çevirme izleme olur.Varsayılan değer file_count 2'dir, ancak kullanarak bir kullanıcı tarafından geçersiz kılındıfilecount seçeneği.

  • Varsayılan değer file_size diğer izlemeler ile olarak 5 MB'tır ve değiştirilebilir.

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

  • Yalnızca aşağıdaki olaylar ve kendi sütun izleme içinde yer alır:

    • RPC başlatma

    • Toplu iş başlatılıyor

    • Özel durum

    • Dikkat

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

  • Süzgeçler, bu izleme için belirtilemez.

İzinler

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

Değişiklik Geçmişi

Güncelleştirilmiş içerik

Özgün izleme dosya adında alt çizgi karakteri kullanmaktan kaçınmaktır öneriyi eklenen @ tracefile bağımsız değişkenin açıklaması.