sp_trace_setstatus (Transact-SQL)
Zmienia bieżący stan określonego śledzenia.
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status
Argumenty
[ @traceid= ] trace_id
Is the ID of the trace to be modified.trace_id is int, with no default.Użytkownik wykorzystuje to trace_idwartość zidentyfikować, modyfikować i kontroli śledzenia. Aby uzyskać informacje na temat pobierania trace_id, zobacz fn_trace_getinfo (Transact-SQL).[ @status= ] status
Specifies the action to implement on the trace.status is int, with no default.Poniższa lista przedstawia stan, który może być określony.
Stan
Description
0
Zatrzymuje określoną śledzenia.
1
Uruchamia określoną śledzenia.
2
Zamyka określone śledzenia i usuwa jego definicji z serwera.
Uwaga
Śledzenie musi zostać zatrzymana najpierw przed jej zamknięciem.Śledzenie musi być zatrzymane i najpierw zamknąć przed mogą być wyświetlane.
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. |
8 |
Podany stan jest nieprawidłowy. |
9 |
Uchwyt określonego śledzenia jest nieprawidłowa. |
13 |
Mało pamięci.Zwracane, gdy jest za mało pamięci do wykonania określonej akcja. |
Jeżeli śledzenie jest już w stanie SQL Server Zwraca wartość 0.
Remarks
(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.
Aby zapoznać się z pomocą śledzenia procedur przechowywanych, zobacz How to: Create a Trace (Transact-SQL).
Uprawnienia
Użytkownik musi mieć uprawnienie ALTER TRACE.