sp_trace_setstatus (języka Transact-SQL)

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

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

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.