sp_trace_setstatus (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Modifica lo stato corrente della traccia specificata.

Importante

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. In alternativa, usare Eventi estesi.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @traceid = ] traceid

ID della traccia da modificare. @traceid è int, senza impostazione predefinita. L'utente usa questo valore @traceid per identificare, modificare e controllare la traccia. Per informazioni sul recupero delle @traceid, vedere sys.fn_trace_getinfo (Transact-SQL).

[ @status = ] status

Specifica l'azione da implementare nella traccia. @status è int, senza impostazione predefinita.

Nella tabella seguente sono inclusi i possibili valori di stato.

Stato Descrizione
0 Arresta la traccia specificata.
1 Avvia la traccia specificata.
2 Chiude la traccia specificata e ne elimina la definizione dal server.

Nota

È necessario che la traccia venga arrestata prima di chiuderla. Prima di visualizzare una traccia, è necessario arrestarla e chiuderla.

Valori del codice restituito

Nella tabella seguente vengono descritti i possibili valori di codice visualizzati al completamento della stored procedure.

Codice restituito Descrizione
0 Nessun errore.
1 Errore sconosciuto.
8 Lo stato specificato non è valido.
9 L'handle di traccia specificato non è valido.
13 Memoria esaurita. Restituito quando non è disponibile memoria sufficiente per eseguire l'azione specificata.

Se la traccia è già nello stato specificato, SQL Server restituisce 0.

Osservazioni:

I parametri di tutte le stored procedure di traccia SQL (sp_trace_*) sono rigorosamente tipizzato. Se questi parametri non vengono chiamati con i tipi di dati dei parametri di input corretti, come specificato nella descrizione dell'argomento, la stored procedure restituisce un errore.

Per un esempio di utilizzo di stored procedure di traccia, vedere Creare una traccia (Transact-SQL).

Autorizzazioni

È richiesta l'autorizzazione ALTER TRACE.

Contenuto correlato