Freigeben über


CursorPrepare-Ereignisklasse

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz

Die CursorPrepare -Ereignisklasse beschreibt cursorvorbereitende Ereignisse, die in API-Cursorn (Application Programming Interface, Anwendungsprogrammierschnittstelle) auftreten. Cursor bereiten Ereignisse vor, wenn microsoft Datenbank-Engine eine SELECT-Anweisung kompiliert, die einem Cursor zugeordnet ist, in einen Ausführungsplan, aber nicht den Cursor erstellt.

Schließen Sie die CursorPrepare -Ereignisklasse in Ablaufverfolgungen ein, die die Leistung von Cursorn aufzeichnen. Wenn die CursorPrepare -Ereignisklasse in eine Ablaufverfolgung eingeschlossen wird, hängt der dadurch entstehende Mehraufwand davon ab, wie oft Cursor während der Ablaufverfolgung für die Datenbank verwendet werden. Wenn Cursor sehr häufig verwendet werden, kann die Ablaufverfolgung die Leistung erheblich beeinträchtigen.

Datenspalten der CursorPrepare-Ereignisklasse

Datenspaltenname Datentyp BESCHREIBUNG Column ID Filterbar
ApplicationName nvarchar Name der Clientanwendung, die die Verbindung mit einer Instanz von SQL Server erstellt hat. Diese Spalte wird mit den Werten aufgefüllt, die von der Anwendung übergeben werden, und nicht mit dem angezeigten Namen des Programms. 10 Ja
ClientProcessID int Die ID, die der Hostcomputer dem Prozess zuweist, in dem die Clientanwendung ausgeführt wird. Diese Datenspalte wird aufgefüllt, wenn die Clientprozess-ID durch den Client bereitgestellt wird. 9 Ja
DatabaseID int Die ID der Datenbank, die durch die USE database -Anweisung angegeben wurde, bzw. die ID der Standarddatenbank, wenn für eine bestimmte Instanz keine USE database -Anweisung ausgegeben wurde. SQL Server Profiler zeigt den Namen der Datenbank an, wenn die ServerName -Datenspalte in der Ablaufverfolgung aufgezeichnet wird und der Server verfügbar ist. Der Wert für eine Datenbank kann mithilfe der DB_ID-Funktion ermittelt werden. 3 Ja
DatabaseName nvarchar Name der Datenbank, in der die Benutzeranweisung ausgeführt wird. 35 Ja
EventClass int Typ des aufgezeichneten Ereignisses = 70. 27 No
EventSequence int Sequenznummer der CursorPrepare -Ereignisklasse in einem Batch. 51 No
GroupID int ID der Arbeitsauslastungsgruppe, in der das SQL-Ablaufverfolgungsereignis ausgelöst wird. 66 Ja
Handle int Handle der Ereignisklasse. 33 Ja
HostName nvarchar Der Name des Computers, auf dem der Client ausgeführt wird. Diese Datenspalte wird aufgefüllt, wenn der Hostname durch den Client bereitgestellt wird. Verwenden Sie die HOST_NAME -Funktion, um den Hostnamen zu bestimmen. 8 Ja
IsSystem int Gibt an, ob das Ereignis bei einem Systemprozess oder einem Benutzerprozess aufgetreten ist. 1 = System, 0 = Benutzer. 60 Ja
LoginName nvarchar Name der Anmeldung des Benutzers (entweder SQL Server-Sicherheitsanmeldung oder Windows-Anmeldeinformationen in Form von DOMÄNE\Benutzername). 11 Ja
LoginSid Abbildung Sicherheits-ID (SID) des angemeldeten Benutzers. Diese Informationen finden Sie in der sys.server_principals -Katalogsicht. Die SID ist für jede Anmeldung beim Server eindeutig. 41 Ja
NTDomainName nvarchar Windows-Domäne, zu der der Benutzer gehört. 7 No
NTUserName nvarchar Windows-Benutzername. 6 Ja
RequestID int ID der Anforderung, die den Cursor vorbereitet hat. 49 Ja
ServerName nvarchar Name der Instanz von SQL Server, die nachverfolgt wird. 26 No
SessionLoginName nvarchar Der Anmeldename des Benutzers, der die Sitzung gestartet hat. Wenn Sie beispielsweise mithilfe von Login1 eine Verbindung mit SQL Server herstellen und eine Anweisung als Login2 ausführen, zeigt SessionLoginName "Login1" und "LoginName " "Login2" an. In dieser Spalte werden sowohl SQL Server- als auch Windows-Anmeldungen angezeigt. 64 Ja
SPID int Die ID der Sitzung, in der das Ereignis aufgetreten ist. 12 Ja
StartTime datetime Der Zeitpunkt, zu dem das Ereignis begonnen hat (falls verfügbar). 14 Ja
TransactionID bigint Die vom System zugewiesene ID der Transaktion. 4 Ja
XactSequence bigint Token zur Beschreibung der aktuellen Transaktion. 50 Ja

Weitere Informationen

Erweiterte Ereignisse
sp_trace_setevent (Transact-SQL)
Cursor