sp_trace_create (Transact-SQL)

Gilt für: SQL Server

Erstellt eine Ablaufverfolgungsdefinition. Die neue Ablaufverfolgung befindet sich in einem angehaltenen Zustand.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @traceid = ] traceid OUTPUT

Die von SQL Server der neuen Ablaufverfolgung zugewiesene Nummer. Alle vom Benutzer bereitgestellten Eingaben werden ignoriert. @traceid ist ein OUTPUT-Parameter vom Typ "int" mit einem Standardwert von NULL. Der Benutzer verwendet den @traceid Wert, um die von dieser gespeicherten Prozedur definierte Ablaufverfolgung zu identifizieren, zu ändern und zu steuern.

[ @options = ] Optionen

Gibt die für die Ablaufverfolgung festgelegten Optionen an. @options ist int, ohne Standardeinstellung. Sie können eine Kombination dieser Optionen auswählen, indem Sie den Summenwert der ausgewählten Optionen angeben. Wenn Sie z. B. sowohl die Optionen TRACE_FILE_ROLLOVER SHUTDOWN_ON_ERRORals auch die @options aktivieren 6 möchten.

In der folgenden Tabelle werden die Optionen, Beschreibungen und die zugehörigen Werte aufgeführt.

[ @tracefile = ] N'tracefile'

Gibt den Speicherort und dateinamen an, in den die Ablaufverfolgung geschrieben wird. @tracefile ist nvarchar(245) ohne Standard. @tracefile kann entweder ein lokales Verzeichnis (zN'C:\MSSQL\Trace\trace.trc'. B. ) oder ein UNC zu einer Freigabe oder einem Pfad (zN'\\<servername>\<sharename>\<directory>\trace.trc'. B. ) sein.

SQL Server fügt eine .trc Erweiterung an alle Ablaufverfolgungsdateinamen an. Wenn die TRACE_FILE_ROLLOVER Option und ein @filecount angegeben werden, erstellt SQL Server eine neue Ablaufverfolgungsdatei, wenn die ursprüngliche Ablaufverfolgungsdatei auf die maximale Größe zunimmt. Die neue Datei hat denselben Namen wie die originale Datei, aber _n wird angefügt, um die Reihenfolge anzugeben, beginnend mit 1. Wenn beispielsweise die erste Ablaufverfolgungsdatei benannt filename.trcist, wird die zweite Ablaufverfolgungsdatei benannt filename_1.trc.

Wenn Sie die TRACE_FILE_ROLLOVER Option verwenden, wird empfohlen, keine Unterstriche im ursprünglichen Namen der Ablaufverfolgungsdatei zu verwenden. Bei Verwendung von Unterstrichen tritt Folgendes auf:

• SQL Server Profiler lädt Sie nicht automatisch oder fordert Sie auf, die Rolloverdateien zu laden (wenn eine dieser Dateirollover-Optionen konfiguriert ist).

• Die sys.fn_trace_gettable-Funktion lädt keine Rolloverdateien (wenn mithilfe des Arguments @number_files angegeben), wobei der ursprüngliche Dateiname mit einem Unterstrich und einem numerischen Wert endet. (Dies gilt nicht für den Unterstrich und die Nummer, die automatisch angefügt wird, wenn eine Datei überrollt wird.)

@tracefile kann nicht angegeben werden, wenn die TRACE_PRODUCE_BLACKBOX Option verwendet wird.

[ @maxfilesize = ] maxfilesize

Gibt die Maximalgröße in Megabyte (MB) an, auf die eine Ablaufverfolgungsdatei vergrößert werden kann. @maxfilesize ist großint, mit einem Standardwert von 5.

Wenn dieser Parameter ohne die TRACE_FILE_ROLLOVER Option angegeben wird, beendet die Ablaufverfolgung die Aufzeichnung in der Datei, wenn der verwendete Speicherplatz die durch @maxfilesize angegebene Menge überschreitet.

[ @stoptime = ] 'stoptime'

Gibt das Datum und die Uhrzeit an, zu denen die Ablaufverfolgung beendet wird. @stoptime ist "datetime" mit der Standardeinstellung "NULL. Wenn NULLdie Ablaufverfolgung ausgeführt wird, bis sie manuell beendet wird oder bis der Server heruntergefahren wird.

Wenn sowohl @stoptime als auch @maxfilesize angegeben werden und TRACE_FILE_ROLLOVER nicht angegeben werden, wird die Ablaufverfolgung tops, wenn entweder die angegebene Stoppzeit oder die maximale Dateigröße erreicht ist. Wenn @stoptime, @maxfilesize und TRACE_FILE_ROLLOVER angegeben werden, hält die Ablaufverfolgung zur angegebenen Stoppzeit an, vorausgesetzt, die Ablaufverfolgung füllt das Laufwerk nicht aus.

[ @filecount = ] 'filecount'

Gibt die maximale Anzahl von Ablaufverfolgungsdateien an, die mit dem gleichen Basisdateinamen verwaltet werden sollen. @filecount ist int, größer als 1. Dieser Parameter ist nur gültig, wenn die TRACE_FILE_ROLLOVER Option angegeben ist. Wenn @filecount angegeben wird, versucht SQL Server, nicht mehr als @filecount Ablaufverfolgungsdateien zu verwalten, indem die älteste Ablaufverfolgungsdatei gelöscht wird, bevor eine neue Ablaufverfolgungsdatei geöffnet wird. SQL Server verfolgt das Alter von Ablaufverfolgungsdateien, indem eine Zahl an den Basisdateinamen angefügt wird.

Wenn beispielsweise der parameter @tracefile als C:\mytraceangegeben wird, ist eine Datei mit dem Namen C:\mytrace_123.trc älter als eine Datei mit dem Namen C:\mytrace_124.trc. Wenn @filecount auf festgelegt 2ist, löscht SQL Server die Datei C:\mytrace_123.trc vor dem Erstellen der Ablaufverfolgungsdatei C:\mytrace_125.trc.

SQL Server versucht nur einmal, jede Datei zu löschen und kann keine Datei löschen, die von einem anderen Prozess verwendet wird. Wenn daher eine andere Anwendung mit Ablaufverfolgungsdateien arbeitet, während die Ablaufverfolgung ausgeführt wird, belässt SQL Server diese Ablaufverfolgungsdateien möglicherweise im Dateisystem.

Rückgabecodewerte

In der folgenden Tabelle werden die Codewerte beschrieben, die Sie nach Abschluss der gespeicherten Prozedur abrufen können.

Hinweise

sp_trace_create ist eine gespeicherte SQL Server-Prozedur, die viele der aktionen ausführt, die zuvor von xp_trace_* erweiterten gespeicherten Prozeduren ausgeführt wurden, die in früheren Versionen von SQL Server verfügbar sind. Verwenden Sie sp_trace_create anstelle von:

• xp_trace_addnewqueue
• xp_trace_setqueuecreateinfo
• xp_trace_setqueuedestination

sp_trace_create erstellt nur eine Ablaufverfolgungsdefinition. Diese gespeicherte Prozedur kann nicht verwendet werden, um eine Ablaufverfolgung zu starten oder zu ändern.

Parameter aller gespeicherten SQL Trace-Prozeduren (sp_trace_*) werden streng eingegeben. Wenn diese Parameter nicht mit den richtigen Datentypen für Eingabeparameter aufgerufen werden, wie in der Argumentbeschreibung angegeben, gibt die gespeicherte Prozedur einen Fehler zurück.

For sp_trace_create, the SQL Server service account must have write permission on the trace file folder. Wenn das SQL Server-Dienstkonto kein Administrator auf dem Computer ist, auf dem sich die Ablaufverfolgungsdatei befindet, müssen Sie explizit schreibberechtigungen für das SQL Server-Dienstkonto erteilen.

Ein Beispiel für die Verwendung gespeicherter Ablaufverfolgungsprozeduren finden Sie unter Erstellen einer Ablaufverfolgung.

TRACE_PRODUCE_BLACKBOX hat die folgenden Merkmale:

• Es ist eine Rolloverablaufverfolgung. Die Standardeinstellung @filecount ist 2, kann jedoch vom Benutzer mit @filecount Option überschrieben werden.

• Die Standard -@maxfilesize wie bei anderen Ablaufverfolgungen beträgt 5 MB und kann geändert werden.

• Es kann kein Dateiname angegeben werden. Die Datei wird gespeichert als: N'%SQLDIR%\MSSQL\DATA\blackbox.trc'.

• Nur die folgenden Ereignisse und deren Spalten sind in der Ablaufverfolgung enthalten:

  • RPC-Start
  • Batchstart
  • Exception
  • Aufmerksamkeit

• Ereignisse oder Spalten können dieser Ablaufverfolgung nicht hinzugefügt oder daraus entfernt werden.

• Filter können für diese Ablaufverfolgung nicht angegeben werden.

Berechtigungen

Erfordert DIE ALTER TRACE-Berechtigung.

Zugehöriger Inhalt

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