sp_trace_create (Transact-SQL)

Si applica a: SQL Server

Crea la definizione di una nuova traccia La nuova traccia si trova in uno stato arrestato.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_trace_create
    [ @traceid = ] traceid OUTPUT
    , [ @options = ] options
    , [ @tracefile = ] N'tracefile'
    [ , [ @maxfilesize = ] maxfilesize ]
    [ , [ @stoptime = ] 'stoptime' ]
    [ , [ @filecount = ] filecount ]
[ ; ]

Argomenti

[ @traceid = ] traceid OUTPUT

Numero assegnato da SQL Server alla nuova traccia. Qualsiasi input fornito dall'utente viene ignorato. @traceid è un parametro OUTPUT di tipo int, con un valore predefinito .NULL L'utente usa il valore @traceid per identificare, modificare e controllare la traccia definita da questa stored procedure.

[ @options = ] opzioni

Specifica le opzioni impostate per la traccia. @options è int, senza impostazione predefinita. È possibile scegliere una combinazione di queste opzioni specificando il valore somma delle opzioni selezionate. Ad esempio, per attivare entrambe le opzioni TRACE_FILE_ROLLOVER e SHUTDOWN_ON_ERROR, specificare 6 per @options.

Nella tabella seguente sono incluse le opzioni e le descrizioni, accompagnate dai relativi valori.

[ @tracefile = ] N'tracefile'

Specifica il percorso e il nome del file in cui viene scritta la traccia. @tracefile è nvarchar(245) senza impostazione predefinita. @tracefile può essere una directory locale ( ad esempio N'C:\MSSQL\Trace\trace.trc') o un UNC a una condivisione o un percorso (ad esempio N'\\<servername>\<sharename>\<directory>\trace.trc').

SQL Server aggiunge un'estensione .trc a tutti i nomi di file di traccia. Se si specifica l'opzione TRACE_FILE_ROLLOVER e un @filecount , SQL Server crea un nuovo file di traccia quando il file di traccia originale aumenta fino alla dimensione massima. Il nuovo file ha lo stesso nome del file originale, ma _n viene aggiunto per indicare la sequenza, a partire da 1. Ad esempio, se il primo file di traccia è denominato filename.trc, il secondo file di traccia è denominato filename_1.trc.

Se si usa l'opzione TRACE_FILE_ROLLOVER , è consigliabile non usare caratteri di sottolineatura nel nome del file di traccia originale. Se vengono utilizzati caratteri di sottolineatura, si verifica il comportamento seguente:

• SQL Server Profiler non carica automaticamente o richiede di caricare i file di rollover (se una di queste opzioni di rollover dei file è configurata).

• La funzione sys.fn_trace_gettable non carica i file di rollover (se specificati usando l'argomento @number_files ) in cui il nome file originale termina con un carattere di sottolineatura e un valore numerico. Non si applica al carattere di sottolineatura e al numero aggiunti automaticamente quando viene eseguito il roll over di un file.

@tracefile non è possibile specificare quando viene usata l'opzione TRACE_PRODUCE_BLACKBOX .

[ @maxfilesize = ] maxfilesize

Specifica le dimensioni massime in megabyte (MB) che possono essere raggiunte da un file di traccia. @maxfilesize è bigint, con un valore predefinito .5

Se questo parametro viene specificato senza l'opzione TRACE_FILE_ROLLOVER , la traccia interrompe la registrazione nel file quando lo spazio su disco utilizzato supera la quantità specificata da @maxfilesize.

[ @stoptime = ] 'stoptime'

Specifica la data e l'ora in cui la traccia verrà arrestata. @stoptime è datetime, con il valore predefinito NULL. Se NULL, la traccia viene eseguita fino a quando non viene arrestata manualmente o fino all'arresto del server.

Se vengono specificati sia @stoptime che @maxfilesize e TRACE_FILE_ROLLOVER non vengono specificati, le prime di traccia quando viene raggiunto il tempo di arresto specificato o la dimensione massima del file. Se @stoptime, @maxfilesize e TRACE_FILE_ROLLOVER vengono specificati, la traccia si arresta al momento di arresto specificato, presupponendo che la traccia non riempia l'unità.

[ @filecount = ] 'filecount'

Specifica il numero massimo di file di traccia da mantenere con lo stesso nome file di base. @filecount è int, maggiore di 1. Questo parametro è valido solo se viene specificata l'opzione TRACE_FILE_ROLLOVER . Quando si specifica @filecount , SQL Server tenta di mantenere non più di @filecount file di traccia eliminando il file di traccia meno recente prima di aprire un nuovo file di traccia. SQL Server tiene traccia dell'età dei file di traccia aggiungendo un numero al nome del file di base.

Ad esempio, quando il parametro @tracefile viene specificato come C:\mytrace, un file con il nome C:\mytrace_123.trc è precedente a un file con il nome C:\mytrace_124.trc. Se @filecount è impostato su 2, SQL Server elimina il file C:\mytrace_123.trc prima di creare il file C:\mytrace_125.trcdi traccia.

SQL Server tenta di eliminare ogni file una sola volta e non può eliminare un file in uso da un altro processo. Pertanto, se un'altra applicazione utilizza file di traccia durante l'esecuzione della traccia, SQL Server potrebbe lasciare questi file di traccia nel file system.

Valori del codice restituito

Nella tabella seguente vengono descritti i valori di codice che è possibile ottenere, dopo il completamento della stored procedure.

Osservazioni:

sp_trace_create è una stored procedure di SQL Server che esegue molte delle azioni eseguite in precedenza da xp_trace_* stored procedure estese disponibili nelle versioni precedenti di SQL Server. Usare sp_trace_create invece di:

• xp_trace_addnewqueue
• xp_trace_setqueuecreateinfo
• xp_trace_setqueuedestination

sp_trace_create crea solo una definizione di traccia. Questa stored procedure non può essere usata per avviare o modificare una traccia.

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 sp_trace_create, l'account del servizio SQL Server deve disporre dell'autorizzazione di scrittura per la cartella del file di traccia. Se l'account del servizio SQL Server non è un amministratore nel computer in cui si trova il file di traccia, è necessario concedere in modo esplicito l'autorizzazione di scrittura all'account del servizio SQL Server.

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

TRACE_PRODUCE_BLACKBOX presenta le caratteristiche seguenti:

• È una traccia di rollover. Il @filecount predefinito è 2, ma può essere sottoposto a override dall'utente usando @filecount opzione.

• Il @maxfilesize predefinito, come con altre tracce, è di 5 MB e può essere modificato.

• Non è possibile specificare alcun nome di file. Il file viene salvato come : N'%SQLDIR%\MSSQL\DATA\blackbox.trc'.

• Nella traccia saranno contenuti solo gli eventi seguenti e le relative colonne:

  • Avvio RPC
  • Avvio batch
  • Eccezione
  • Attenzione

• Non è possibile aggiungere o rimuovere eventi o colonne da questa traccia.

• Non è possibile specificare filtri per questa traccia.

Autorizzazioni

È richiesta l'autorizzazione ALTER TRACE.

Contenuto correlato

• sp_trace_generateevent (Transact-SQL)
• sp_trace_setevent (Transact-SQL)
• sp_trace_setfilter (Transact-SQL)
• sp_trace_setstatus (Transact-SQL)
• Traccia SQL