Udostępnij za pośrednictwem

  • Artykuł

sp_trace_create (Transact-SQL)

Tworzy definicję śledzenia.Nowe śledzenia będzie w stanie zatrzymania.

Topic link iconKonwencje składni języka Transact-SQL

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

Argumenty

  • [ @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.Użytkownik wykorzystuje trace_id wartość zidentyfikować, modyfikować i kontroli śledzenia zdefiniowanych za pomocą tej procedura przechowywana.

  • [ @options= ] option_value
    Specifies the options set for the trace.option_value is int, with no default.Użytkownicy mogą wybrać kombinacji tych opcji przez określenie wartości Suma opcji pobrane.Na przykład Włącz obie opcje TRACE_FILE_ROLLOVER i SHUTDOWN_ON_ERROR, określanie 6 for option_value.

    Poniższa tabela zawiera listę opcji, opisy i ich wartości.

    Nazwa opcji

    Wartość opcji

    Description

    TRACE_FILE_ROLLOVER

    2

    Określa, że gdy max_file_size zostanie osiągnięty, bieżący plik śledzenia jest zamknięty i zostanie utworzony nowy plik. Wszystkie nowe rekordy zostaną zapisane do nowego pliku.Nowy plik ma taką samą nazwę jak poprzedni plik, ale liczbą całkowitą zostanie dołączony do wskazania jego sekwencji.Na przykład jeśli oryginalny plik śledzenia nosi nazwę filename.trc, następny plik śledzenia nosi nazwę filename_1.trc, następujący plik śledzenia jest filename_2.trc i tak dalej.

    Co więcej najazdu śledzenia pliki są tworzone, wartość całkowitą, dołączane do zwiększenia nazwy pliku sekwencyjnie.

    Program SQL Server używa wartości domyślnej max_file_size (5 MB), jeśli opcja ta jest określona bez określenia wartości parametru max_file_size.

    SHUTDOWN_ON_ERROR

    4

    Określa, że jeżeli śledzenie nie można zapisać do pliku, niezależnie od powodu, program SQL Server zakończy działanie.Ta opcja jest przydatna podczas wykonywania ślady inspekcji zabezpieczeń.

    TRACE_PRODUCE_BLACKBOX

    8

    Określa, że rekord ostatniego 5 MB śledzenia informacji generowanych przez serwer będą zapisywane przez serwer.TRACE_PRODUCE_BLACKBOX jest niezgodna z innymi opcjami.

  • [ @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 dołączy .TRC rozszerzenia nazw wszystkich plików śledzenia.Jeśli opcja TRACE_FILE_ROLLOVER i max_file_size określono, SQL Server Tworzy nowy plik śledzenia, jeśli oryginalny plik śledzenia powiększa się do jego maksymalnego rozmiaru. Nowy plik ma taką samą nazwę jak plik oryginalny, ale _n jest dołączany do wskazania jego kolejności, począwszy od 1.Na przykład, jeśli nosi nazwę pierwszego pliku śledzenia FILENAME.TRC, drugi plik śledzenia jest o nazwie filename_1.TRC.

    Jeżeli opcja TRACE_FILE_ROLLOVER firma Microsoft zaleca, że znaki podkreślenia nie należy używać w oryginalnej nazwy plik śledzenia.Jeśli zostanie użyte znaki podkreślenia, następujące zachowanie:

    • SQL Server Profiler czy automatycznie obciążenia lub monit o załadowanie plików najazdu (Jeżeli skonfigurowano dowolnej z tych opcji przerzucanie pliku).

    • Funkcja fn_trace_gettable nie ładuje pliki najazdu (gdy określona przy użyciu number_files argument) w przypadku gdy kończy się oryginalną nazwę pliku z podkreśleniem i wartość liczbową. (To nie ma zastosowania do podkreślenia i liczby, które są dołączane automatycznie, kiedy plik toczy się.)

    Uwaga

    Jako obejście dla obu tych zachowań można zmienić nazwy plików do usunięcia podkreślenia w oryginalnej nazwy pliku.Na przykład, jeśli oryginalny plik nosi nazwę my_trace.TRCnosi , a plik przerzucaniamy_trace_1.TRC, można zmienić nazwy plików do mytrace.TRC and mytrace_1.TRC przed otwarciem plików w SQL Server Profiler.

    trace_file Nie można określić, kiedy jest używana opcja TRACE_PRODUCE_BLACKBOX.

  • [ @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.

    Jeśli ten parametr jest określona bez opcji TRACE_FILE_ROLLOVER, śledzenie miejsca na dysku używane przekracza kwotę określoną przez, zatrzymuje rejestrowanie w pliku 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.Jeśli wartością tą jest NULL, śledzenie działa do czasu ręcznego zatrzymania lub serwer jest zamykany.

    Jeśli oba stop_time i max_file_size podano, i TRACE_FILE_ROLLOVER nie jest określony, śledzenie wierzchołki po osiągnięciu Godzina zakończenia określonego albo maksymalny rozmiar pliku. Jeśli stop_time, max_file_size, a TRACE_FILE_ROLLOVER są określone, śledzenie zatrzymuje się na czas określony znacznik, przy założeniu, że śledzenie nie zapełnić dysk.

  • [ @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.Ten parametr jest prawidłowy tylko wtedy, gdy określona jest opcja TRACE_FILE_ROLLOVER.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.

    Na przykład, jeśli trace_fileparametr jest określony jako "c:\mytrace", plik o nazwie „ c:\mytrace_123.trc"jest starszy niż plik o nazwie „ c:\mytrace_124.trc". Jeśli max_rollover_filesjest ustawiona na wartość 2, a następnie program SQL Server usuwa plik "c:\mytrace_123.trc" przed utworzeniem plik śledzenia "c:\mytrace_125.trc".

    Zwróć uwagę, że SQL Server tylko próbuje usunąć wszystkich plików na raz i nie można usunąć pliku, który jest używany przez inny proces. Dlatego jeśli inna aplikacja działa z plikami śledzenia podczas śledzenia jest uruchomiony, SQL Server może pozostawić te pliki śledzenia w systemie plików.

Wartości kodów powrotnych

W poniższej tabela opisano wartości kodów, że użytkownicy mogą uzyskać po przeprowadzeniu procedura przechowywana.

Zwraca kod

Description

0

Brak błędu.

1

Nieznany błąd.

10

Nieprawidłowe opcje.Zwracane, gdy opcje określane są niezgodne.

12

Nie utworzono plik.

13

Mało pamięci.Zwracane, gdy jest za mało pamięci do wykonania określonej akcja.

14

Czas zatrzymania nieprawidłowe.Zwracane, gdy już wystąpił określony czas przestoju.

15

Nieprawidłowe parametry.Zwracane, gdy użytkownik podane parametry niezgodne.

Remarks

sp_trace_create is a SQL Server Procedura przechowywana, która wykonuje wiele działań wcześniej wykonywane przez xp_trace_ * rozszerzonych procedur przechowywanych, które są dostępne we wcześniejszych wersjach programu SQL Server.Użycie sp_trace_create zamiast:

  • Pośrednik: przesłana dalej wiadomości wysłane

  • xp_trace_setqueuecreateinfo

  • xp_trace_setqueuedestination

sp_trace_create tworzy tylko definicję śledzenia.Ta procedura przechowywana nie może służyć do uruchamiania lub zmienić śledzenia.

(Procedury przechowywane parametry wszystkich śledzenia SQLsp_trace_xx) ściśle są wpisane.Jeśli te parametry nie są nazywane z typami danych prawidłowego parametru wejściowego, jak określono w opisie argumentu procedura przechowywana zwróci błąd.

Dla sp_trace_create, the SQL Server konto usługa musi mieć uprawnienie do zapisu w folderze plików śledzenia. Jeśli SQL Server konto usługa nie jest administratorem na komputerze, na którym znajduje się plik śledzenia, należy jawnie udzielić uprawnień do zapisu do SQL Server konto usługa.

Uwaga

Można automatycznie załadować utworzone za pomocą plik śledzenia sp_trace_create do tabela za pomocą fn_trace_gettable Funkcja systemowa. Aby uzyskać informacje dotyczące korzystania z tej funkcja systemu Zobacz fn_trace_gettable (Transact-SQL).

Aby zapoznać się z pomocą śledzenia procedur przechowywanych, zobacz How to: Create a Trace (Transact-SQL).

TRACE_PRODUCE_BLACKBOX ma następujące właściwości:

  • Jest śledzenia najazdu.Wartość domyślna file_count 2, ale może zostać zastąpiona przez użytkownika za pomocą filecount opcji.

  • Wartość domyślna file_size jak z innymi ślady 5 MB i mogą być zmieniane.

  • Nie nazwy pliku może być określony.Plik zostanie zapisany jako: N'%SQLDIR%\MSSQL\DATA\blackbox.TRC "

  • Następujące zdarzenia i ich kolumn znajdują się w śledzenia:

    • Uruchomienie usługi RPC

    • Uruchamianie zadań wsadowych

    • Wyjątek

    • Uwaga

  • Zdarzenia i kolumny nie dodane lub usunięte z tego śledzenia.

  • Filtrów nie mogą być określone dla tego śledzenia.

Uprawnienia

Użytkownik musi mieć uprawnienie ALTER TRACE.

Historia zmian

Microsoft Learning

Zalecenie, aby uniknąć używania znaków podkreślenia w oryginalną nazwę plik śledzenia, aby dodać @ tracefile opis argumentu.