sp_trace_setstatus (języka Transact-SQL)
Modyfikuje bieżący stan określonego śledzenia.
.gif "Ikona łącza do tematu")
Składnia
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status
Argumenty
[ @traceid= ] trace_id
Jest to identyfikator śledzenia ma być zmodyfikowany.trace_idjest int, z braku domyślne.Użytkownik wykorzystuje to trace_idwartość do identyfikowania, modyfikowanie i kontroli śledzenia.Aby uzyskać informacje dotyczące pobierania trace_id, zobacz fn_trace_getinfo (języka Transact-SQL).[ @status= ] status
Określa akcja do wykonania na śledzenie.statusjest int, z braku domyślne.W poniższej tabela wymieniono stan, który może być określony.
Stan
Opis
0
Zatrzymuje śledzenie określonego.
1
Uruchamia określony śledzenia.
2
Zamyka określone śledzenia i usuwa jego definicji z serwera.
Ostrzeżenie
Śledzenie musi zostać zatrzymana najpierw przed jej zamknięciem.Śledzenie musi być zatrzymane i najpierw zamknąć zanim będzie możliwe.
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. |
8 |
Podany stan jest nieprawidłowy. |
9 |
Określone dojście śledzenia jest nieprawidłowa. |
13 |
Za mało pamięci.Zwracane jest za mało pamięci do wykonania określonej akcja. |
Jeśli śledzenie jest już w stanie określić, SQL Server zwróci 0.
Uwagi
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.
Przykład za pomocą procedur przechowywanych śledzenia zobacz Jak Create Trace (Transact-SQL).
Uprawnienia
Użytkownik musi mieć uprawnienie Zmiana śledzenia.