sp_trace_setstatus (Transact-SQL)

  • Articolo

Modifica lo stato corrente della traccia specificata.

Nota importanteImportante

Questa funzionalità verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. In alternativa, utilizzare Eventi estesi.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @traceid= ] trace_id
    ID della traccia da modificare. trace_id è di tipo int e non prevede alcun valore predefinito. Tramite il valore trace_id l'utente può identificare, modificare e controllare la traccia. Per informazioni sul recupero del valore trace_id, vedere sys.fn_trace_getinfo (Transact-SQL).

  • [ @status= ] status
    Specifica l'azione da implementare nella traccia. status è di tipo int e non prevede alcun valore predefinito.

    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]

    Prima di chiudere una traccia, è necessario arrestarla. Prima di visualizzare una traccia, è necessario arrestarla e chiuderla.

Valori restituiti

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 la quantità di memoria disponibile non è sufficiente per eseguire l'azione specificata.

Se lo stato corrente della traccia corrisponde a quello specificato, SQL Server restituisce 0.

Osservazioni

I parametri di tutte le stored procedure Traccia SQL (sp_trace_xx) devono essere fortemente tipizzati. Se questi parametri non vengono chiamati con i tipi di dati corretti per i parametri di input, come indicato nella descrizione dell'argomento, la stored procedure restituirà un errore.

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

Autorizzazioni

L'utente deve disporre dell'autorizzazione ALTER TRACE.

Vedere anche

Riferimento

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)

Concetti

Traccia SQL