Udostępnij za pośrednictwem


sp_trace_create (języka Transact-SQL)

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

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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
    Jest to numer przypisany przez Microsoft SQL Server do nowej śledzenia.Wszelkie dane wejściowe użytkownika zostanie zignorowany.trace_idjest int, domyślna wartość NULL.Użytkownik wykorzystuje trace_id wartość zidentyfikować, modyfikować i kontroli śledzenia zdefiniowanych za pomocą tej procedura składowana.

  • [ @options= ] option_value
    Określa opcje zestaw dla śledzenia.option_valuejest int, z braku domyślne.Użytkownicy mogą wybrać kombinacji tych opcji, określając wartość sumy pobrane opcje.Na przykład, aby włączyć obie opcje TRACE_FILE_ROLLOVER i SHUTDOWN_ON_ERROR, należy określić 6 dla option_value.

    W poniższej tabela przedstawiono opcje, opisy i ich wartości.

    Nazwa opcji

    Wartość opcji

    Opis

    TRACE_FILE_ROLLOVER

    2

    Określa, że po max_file_size zostanie osiągnięty bieżący plik śledzenia jest zamknięty i tworzony jest nowy plik.Wszystkie nowe rekordy zostaną zapisane do nowego pliku.Nowy plik będzie miał 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 ma nazwę filename.trc, następny plik śledzenia o nazwie filename_1.trc, jest następujący plik śledzenia , filename_2.trc i tak dalej.

    Nowe pliki śledzenia najazdu są tworzone, wartość całkowitą, dołączane do zwiększenia nazwę pliku sekwencyjnie.

    SQL Serwer używa domyślnej wartości max_file_size (5 MB) Jeśli ta opcja jest określona bez określenia wartości dla max_file_size.

    SHUTDOWN_ON_ERROR

    4

    Określa, że jeżeli śledzenie nie można zapisać do pliku niezależnie od powodu, SQL Server przebiega niedziałający.Ta opcja jest przydatna podczas wykonywania śladów inspekcji zabezpieczeń.

    TRACE_PRODUCE_BLACKBOX

    8

    Określa, że rekord ostatniego 5 MB śledzenia informacji generowanych przez serwer zostaną zapisane przez serwer.TRACE_PRODUCE_BLACKBOX jest niezgodna z innymi opcjami.

  • [ @tracefile= ] 'trace_file'
    Określa lokalizację i nazwę pliku, w którym będą zapisywane śledzenia.trace_filejest nvarchar(245)z nie domyślnych.trace_filemoże być katalogiem lokalnym (na przykład N 'C:\MSSQL\Trace\trace.trc') lub do udziału lub ścieżka UNC (N'\\nazwa_serwera\nazwa_udziału\katalog\trace.trc ").

    SQL Serverdołączy .trc rozszerzenia nazw wszystkich plik śledzenia .Jeśli opcja TRACE_FILE_ROLLOVER i max_file_size są określone, SQL Server tworzy nowy plik śledzenia , gdy oryginalny plik śledzenia powiększa się do jego maksymalnego rozmiaru.Nowy plik ma taką samą nazwę jak plik oryginalny, ale _n jest dołączana do wskazania jego sekwencji, począwszy od 1.Na przykład, jeśli nazwę pierwszego plik śledzenia filename.trc, nosi nazwę drugiego plik śledzenia filename_1.trc.

    Użyj opcji TRACE_FILE_ROLLOVER zaleca się w oryginalnej nazwy plik śledzenia nie należy używać znaków podkreślenia.Jeśli używasz podkreślenia, następujące zachowanie:

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

    • fn_trace_gettablefunkcja nie ładuje pliki najazdu (gdy określony za pomocą number_files argument) gdzie oryginalną nazwę pliku kończy podkreślenia i wartości numeryczne.(Nie dotyczy to podkreślenia i numer, który są dołączane automatycznie, gdy przyrost pliku.)

    Ostrzeżenie

    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 o nazwie my_trace.trc, oraz o nazwie plik przerzucania my_trace_1.trc, można zmienić nazwy plików do mytrace.trc i mytrace_1.trc przed otwarciem plików w SQL Server Profiler.

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

  • [ @maxfilesize= ] max_file_size
    Określa, że można powiększać maksymalny rozmiar w megabajtach (MB) w plik śledzenia .max_file_sizejest bigint, z wartością domyślną 5.

    Jeśli ten parametr jest określona bez opcji TRACE_FILE_ROLLOVER, śledzenie miejsca na dysku używana przekracza kwotę określoną przez, zatrzymuje rejestrowanie w pliku max_file_size.

  • [ @stoptime= ] 'stop_time'
    Określa data i czas śledzenia zostaną zatrzymane.stop_timejest datetime, domyślna wartość NULL.Jeśli ma wartość NULL, śledzenie jest uruchamiana do momentu ręcznego zatrzymania lub do serwera wyłączany niedziałający.

    Jeśli oba stop_time i max_file_size są określone i TRACE_FILE_ROLLOVER nie jest określony, śledzenie wierzchołki, po osiągnięciu zatrzymania podanego czas lub maksymalny rozmiar pliku.Jeśli stop_time, max_file_sizei TRACE_FILE_ROLLOVER są określone, zatrzymuje śledzenie w zatrzymania podanego czas, przy założeniu, że śledzenie nie zapełnić dysk.

  • [ @filecount= ] 'max_rollover_files'
    Określa maksymalną liczbę lub śledzenia plików do utrzymywane z tej samej podstawowej nazwy pliku.max_rollover_filesjest int, jest większa niż jeden.Ten parametr jest prawidłowy tylko wtedy, gdy określono opcję TRACE_FILE_ROLLOVER.Po max_rollover_files jest określony, SQL Server usiłuje utrzymać nie więcej niż max_rollover_files śledzenia plików przez usunięcie najstarszy plik śledzenia przed otwarciem nowego plik śledzenia.SQL Serverśledzi wieku plików śledzenia, dołączając numer do bazowa nazwa pliku.

    Na przykład, jeśli trace_file parametr jest określony jako "c:\mytrace", plik o nazwie "c:\mytrace_123.trc" jest starsza niż plik o nazwie "c:\mytrace_124.trc".Jeśli max_rollover_files jest zestaw do 2, następnie usuwa SQL Server plik "c:\mytrace_123.trc" Przed utworzeniem plik śledzenia "c:\mytrace_125.trc".

    Należy zauważyć, że SQL Server tylko próbuje usunąć jeden raz, każdy plik i nie można usunąć pliku, który jest używany przez inny proces.W związku z tym, jeśli inna aplikacja działa z plików ś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 kodu, że użytkownicy mogą uzyskać po przeprowadzeniu procedura składowana.

Kod powrotu

Opis

0

Nie ma błędów.

1

Nieznany błąd.

10

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

12

Nie utworzono plik.

13

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

14

Stop nieprawidłowy czas.Zwracane, gdy już wystąpił stop czas określony.

15

Nieprawidłowe parametry.Zwracane, gdy niezgodny parametrów dostarczonych przez użytkownika.

Uwagi

sp_trace_create jest SQL Server procedura składowana , który wykonuje wiele działań wykonanych wcześniej przez xp_trace_ * rozszerzonych procedur przechowywanych, które są dostępne w starszych wersjach SQL Server.Użycie sp_trace_create zamiast:

  • xp_trace_addnewqueue

  • xp_trace_setqueuecreateinfo

  • xp_trace_setqueuedestination

sp_trace_create tworzy tylko definicję śledzenia.Ta procedura składowana nie można użyć do uruchomienia lub zmienić śledzenia.

Parametry śledzenia SQL wszystkie procedury przechowywane (sp_trace_xx) są ściśle wpisane.Jeśli te parametry nie są nazywane z typami danych prawidłowych parametrów wejściowych, jak określono w opisie argumentu procedura składowana zwróci błąd.

Dla sp_trace_create, SQL Serverkontousługa musi mieć uprawnienia do zapisu w plik śledzenia . Jeśli SQL Serverkontousługa nie jest administratorem na komputerze, na którym znajduje się plik śledzenia , należy jawnie udzielić uprawnienia do zapisu w SQL Serverkontausługa .

Ostrzeżenie

Można automatycznie załadować plik śledzenia , utworzony za pomocą sp_trace_create do tabela za pomocą fn_trace_gettable funkcjasystemowej.Aby uzyskać informacje dotyczące sposobu korzystania z funkcjasystemu, zobacz fn_trace_gettable (języka Transact-SQL).

Przykład za pomocą procedur przechowywanych śledzenia zobacz Jak Create Trace (Transact-SQL).

TRACE_PRODUCE_BLACKBOX ma następujące cechy:

  • Jest śledzenia najazdu.Domyślnie file_count 2, ale może być zastąpiona przez użytkownika za pomocą filecount opcji.

  • Domyślnie file_size z innych śladów 5 MB i mogą być zmieniane.

  • Można określić żadnej nazwy pliku.Plik zostanie zapisany jako: N'%SQLDIR%\MSSQL\DATA\blackbox.TRC "

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

    • Uruchomienie usługi RPC

    • Uruchamianie przetwarzania wsadowego

    • Wyjątek

    • Uwagi

  • Zdarzenia lub kolumn nie dodawany lub usuwany z tej śledzenia.

  • Filtrów nie można określić dla tego śledzenia.

Uprawnienia

Użytkownik musi mieć uprawnienie Zmiana śledzenia.