CursorPrepare-Ereignisklasse

Die CursorPrepare-Ereignisklasse beschreibt Cursorvorbereitungsereignisse, die in API-Cursorn (Application Programming Interface) auftreten. Cursor-Vorbereitungsereignisse treten auf, wenn das Microsoft-Datenbankmodul eine SELECT-Anweisung, die einem Cursor zugeordnet ist, in einen Ausführungsplan umwandelt, aber jedoch den Cursor nicht erstellt.

Schließen Sie die CursorPrepare-Ereignisklasse in Ablaufverfolgungen ein, die die Leistung von Cursoren aufzeichnen. Wenn die CursorPrepare-Ereignisklasse in einer Ablaufverfolgung enthalten ist, hängt der entstehende Mehraufwand davon ab, wie häufig Cursor während der Ablaufverfolgung gegen die Datenbank verwendet werden. Wenn Cursor ausgiebig verwendet werden, kann die Ablaufverfolgung die Leistung erheblich beeinträchtigen.

CursorPrepare-Ereignisklassendatenspalten

Datenspaltenname	Datentyp	BESCHREIBUNG	Spalten-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	Nein
EventSequence	Int	Sequenz der CursorPrepare-Ereignisklasse im Batch.	51	Nein
GroupID	Int	ID der Arbeitsauslastungsgruppe, in der das SQL-Ablaufverfolgungsereignis ausgelöst wird.	66	Ja
Griff	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	Nein
NTUserName	nvarchar	Windows-Benutzername.	6	Ja
RequestID	Int	Fordern Sie die Identifikation des Vorgangs an, der den Cursor vorbereitet hat.	49	Ja
ServerName	nvarchar	Name der Instanz von SQL Server, die nachverfolgt wird.	26	Nein
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

Siehe auch

Erweiterte Ereignisse
sp_trace_setevent (Transact-SQL)
Cursor