Udostępnij za pośrednictwem

sp_trace_setstatus (Transact-SQL)

  • Artykuł

Dotyczy:programu SQL Server

Modyfikuje bieżący stan określonego śledzenia.

Ważny

Ta funkcja zostanie usunięta w przyszłej wersji programu SQL Server. Unikaj używania tej funkcji w nowych pracach programistycznych i zaplanuj modyfikowanie aplikacji, które obecnie korzystają z tej funkcji. Zamiast tego użyj zdarzeń rozszerzonych.

Transact-SQL konwencje składni

Składnia

sp_trace_setstatus
    [ @traceid = ] traceid
    , [ @status = ] status
[ ; ]

Argumenty

Ważny

Argumenty dla rozszerzonych procedur składowanych należy wprowadzić w określonej kolejności zgodnie z opisem w sekcji składni. Jeśli parametry są wprowadzane poza kolejnością, wystąpi komunikat o błędzie.

[ @traceid = ] traceid

Identyfikator śledzenia do zmodyfikowania. @traceid jest int bez wartości domyślnej. Użytkownik wykorzystuje tę wartość @traceid do identyfikowania, modyfikowania i kontrolowania śledzenia. Aby uzyskać informacje o pobieraniu @traceid, zobacz sys.fn_trace_getinfo.

[ @status = ] stan

Określa akcję do zaimplementowania w śladzie. @status jest int bez wartości domyślnej.

W poniższej tabeli wymieniono stan, który można określić.

Stan Opis
0 Zatrzymuje określony ślad.
1 Uruchamia określony ślad.
2 Zamyka określony ślad i usuwa jego definicję z serwera.

Nuta

Aby można było go zamknąć, należy najpierw zatrzymać ślad. Aby można było wyświetlić ślad, należy go najpierw zatrzymać i zamknąć.

Zwracanie wartości kodu

W poniższej tabeli opisano wartości kodu, które można uzyskać, po zakończeniu procedury składowanej.

Kod powrotny Opis
0 Brak błędu.
1 Nieznany błąd.
8 Określony stan jest nieprawidłowy.
9 Określony uchwyt śledzenia jest nieprawidłowy.
13 Brak pamięci. Zwracany, gdy nie ma wystarczającej ilości pamięci, aby wykonać określoną akcję.

Jeśli ślad jest już w określonym stanie, program SQL Server zwraca 0.

Uwagi

Parametry wszystkich procedur składowanych śledzenia SQL (sp_trace_*) są ściśle typizowane. Jeśli te parametry nie są wywoływane z poprawnymi typami danych parametrów wejściowych, jak określono w opisie argumentu, procedura składowana zwraca błąd.

Aby zapoznać się z przykładem używania procedur składowanych śledzenia, zobacz Create a Trace.

Uprawnienia

Wymaga uprawnienia ALTER TRACE.

Powiązana zawartość