Sdílet prostřednictvím

sp_trace_setstatus (Transact-SQL)

  • Článek

platí pro:SQL Server

Upraví aktuální stav zadaného trasování.

Důležitý

Tato funkce bude odebrána v budoucí verzi SQL Serveru. Nepoužívejte tuto funkci v nové vývojové práci a naplánujte úpravu aplikací, které tuto funkci aktuálně používají. Místo toho použijte rozšířené události.

Transact-SQL konvence syntaxe

Syntax

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

Argumenty

Důležitý

Argumenty rozšířených uložených procedur musí být zadány v určitém pořadí, jak je popsáno v části Syntaxe. Pokud jsou parametry zadány mimo pořadí, dojde k chybové zprávě.

[ @traceid = ] traceid

ID trasování, které se má upravit. @traceid je int, bez výchozího nastavení. Uživatel používá tuto @traceid hodnotu k identifikaci, úpravě a řízení trasování. Informace o načtení @traceidnaleznete v tématu sys.fn_trace_getinfo.

[ @status = ] stav

Určuje akci, která se má implementovat v trasování. @status je , bez výchozího nastavení.

Následující tabulka uvádí stav, který lze zadat.

Stav Popis
0 Zastaví zadané trasování.
1 Spustí zadané trasování.
2 Zavře zadané trasování a odstraní jeho definici ze serveru.

Poznámka

Trasování musí být nejprve zastaveno, aby bylo možné ho zavřít. Před zobrazením musí být trasování zastaveno a uzavřeno.

Návratové hodnoty kódu

Následující tabulka popisuje hodnoty kódu, které můžete získat po dokončení uložené procedury.

Návratový kód Popis
0 Žádná chyba.
1 Neznámá chyba.
8 Zadaný stav není platný.
9 Zadaný popisovač trasování není platný.
13 Nedostatek paměti. Vráceno, pokud není dostatek paměti k provedení zadané akce.

Pokud je trasování již v zadaném stavu, sql Server vrátí 0.

Poznámky

Parametry všech uložených procedur sql Trace (sp_trace_*) jsou výhradně zadané. Pokud tyto parametry nejsou volána se správnými datovými typy vstupních parametrů, jak je uvedeno v popisu argumentu, uložená procedura vrátí chybu.

Příklad použití uložených procedur trasování najdete v tématu Vytvořenítrasování .

Dovolení

Vyžaduje oprávnění ALTER TRACE.

Související obsah

  • sys.fn_trace_geteventinfo (Transact-SQL)
  • sys.fn_trace_getfilterinfo (Transact-SQL)
  • sp_trace_generateevent (Transact-SQL)
  • sp_trace_setevent (Transact-SQL)
  • sp_trace_setfilter (Transact-SQL)
  • trasování SQL