sp_trace_setstatus (Transact-SQL)sp_trace_setstatus (Transact-SQL)

SI APPLICA A: sìSQL Server noDatabase SQL di Azure noAzure SQL Data Warehouse noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Modifica lo stato corrente della traccia specificata.Modifies the current state of the specified trace.

Importante

Questa funzionalità è in manutenzione e potrebbe essere rimossa in una delle prossime versioni di Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. In alternativa, usare Eventi estesi.Use Extended Events instead.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax

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

ArgomentiArguments

[ @traceid = ] trace_id È l'ID della traccia da modificare.[ @traceid = ] trace_id Is the ID of the trace to be modified. trace_id viene int, non prevede alcun valore predefinito.trace_id is int, with no default. L'utente può trace_id valore da identificare, modificare e controllare la traccia.The user employs this trace_id value to identify, modify, and control the trace. Per informazioni sul recupero il trace_id, vedere sys.fn_trace_getinfo (Transact-SQL).For information about retrieving the trace_id, see sys.fn_trace_getinfo (Transact-SQL).

[ @status = ] status Specifica l'azione da implementare nella traccia.[ @status = ] status Specifies the action to implement on the trace. lo stato viene int, non prevede alcun valore predefinito.status is int, with no default.

Nella tabella seguente sono inclusi i possibili valori di stato.The following table lists the status that may be specified.

StatoStatus DescrizioneDescription
00 Arresta la traccia specificata.Stops the specified trace.
11 Avvia la traccia specificata.Starts the specified trace.
22 Chiude la traccia specificata e ne elimina la definizione dal server.Closes the specified trace and deletes its definition from the server.

Nota

È necessario che la traccia venga arrestata prima di chiuderla.A trace must be stopped first before it can be closed. Prima di visualizzare una traccia, è necessario arrestarla e chiuderla.A trace must be stopped and closed first before it can be viewed.

Valori restituitiReturn Code Values

Nella tabella seguente vengono descritti i possibili valori di codice visualizzati al completamento della stored procedure.The following table describes the code values that users may get following completion of the stored procedure.

Codice restituitoReturn code DescrizioneDescription
00 Nessun errore.No error.
11 Errore sconosciuto.Unknown error.
88 Lo stato specificato non è valido.The specified Status is not valid.
99 L'handle di traccia specificato non è valido.The specified Trace Handle is not valid.
1313 Memoria esaurita.Out of memory. Restituito quando la quantità di memoria disponibile non è sufficiente per eseguire l'azione specificata.Returned when there is not enough memory to perform the specified action.

Se la traccia è già nello stato specificato, SQL ServerSQL Server restituirà 0.If the trace is already in the state specified, SQL ServerSQL Server will return 0.

NoteRemarks

I parametri di traccia SQL tutte le stored procedure (sp_trace_xx) sono fortemente tipizzati.Parameters of all SQL Trace stored procedures (sp_trace_xx) are strictly typed. 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.If these parameters are not called with the correct input parameter data types, as specified in the argument description, the stored procedure will return an error.

Per un esempio dell'uso di stored procedure relative alla traccia, vedere Creare una traccia (Transact-SQL).For an example of using trace stored procedures, see Create a Trace (Transact-SQL).

PermissionsPermissions

L'utente deve disporre delle autorizzazioni ALTER TRACE.User must have ALTER TRACE permission.

Vedere ancheSee Also

sys.fn_trace_geteventinfo (Transact-SQL) sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_getfilterinfo (Transact-SQL) sys.fn_trace_getfilterinfo (Transact-SQL)
sp_trace_generateevent (Transact-SQL) sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL) sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL) sp_trace_setfilter (Transact-SQL)
Traccia SQLSQL Trace