sp_trace_setstatus (Transact-SQL)

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

Topic link iconKonwencje składni języka Transact-SQL

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.