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 relative alla 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 del @traceid, vedere sys.fn_trace_getinfo.

[ @status = ] status

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

La tabella seguente elenca lo stato che è possibile specificare.

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 valori di codice che è possibile ottenere, dopo il 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 tali parametri non vengono chiamati con i tipi di dati corretti per i parametri di input, come indicato nella descrizione dell'argomento, la stored procedure restituisce un errore.

Per un esempio di utilizzo di stored procedure di traccia, vedere Creare una traccia.

Autorizzazioni

È richiesta l'autorizzazione ALTER TRACE.

Contenuto correlato