CursorOpen-Ereignisklasse

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

Die CursorOpen -Ereignisklasse beschreibt cursoröffnende Ereignisse, die in API-Cursors (Application Programming Interface, Anwendungsprogrammierschnittstelle) auftreten. Ereignisse beim Öffnen des Cursors treten auf, wenn die SQL Server-Datenbank-Engine die SQL-Anweisung definiert, die dem Cursor und den Cursoroptionen zugeordnet werden soll, und füllt dann den Cursor auf.

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

Datenspalten der CursorOpen-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 der Client die Clientprozess-ID angibt.	9	Ja
DatabaseID	int	Die ID der Datenbank, die durch die USE Datenbank -Anweisung angegeben wurde, bzw. die ID der Standarddatenbank, wenn für eine bestimmte Instanz keine USE Datenbank-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 = 53.	27	No
EventSequence	int	Die Sequenz der CursorOpen -Ereignisklasse im Batch.	51	No
GroupID	int	ID der Arbeitsauslastungsgruppe, in der das SQL-Ablaufverfolgungsereignis ausgelöst wird.	66	Ja
Handle	int	Eine ganze Zahl, die von ODBC, OLE DB oder DB-Library zum Koordinieren der Ausführung mit dem Server verwendet wird.	33	Ja
HostName	nvarchar	Der Name des Computers, auf dem der Client ausgeführt wird. Diese Datenspalte wird aufgefüllt, wenn der Hostname vom Client bereitgestellt wird. Verwenden Sie die HOST_NAME -Funktion, um den Hostnamen zu bestimmen.	8	Ja
IntegerData	int	Cursortyp. Gültige Werte: 1 = Keyset 2 = Dynamisch 4 = Vorwärtscursor 8 = Statisch 16 = Schneller Vorlauf	25	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 Microsoft Windows-Anmeldeinformationen in Form von DOMÄNE\Benutzername).	11	Ja
LoginSid	Abbildung	Die Sicherheits-ID (Security Identifier, 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	Ja
NTUserName	nvarchar	Windows-Benutzername.	6	Ja
RequestID	int	Die Anforderungs-ID, von der der Cursor geöffnet wurde.	49	Ja
ServerName	nvarchar	Name der Instanz von SQL Server, die nachverfolgt wird.	26	No
SessionLoginName	nvarchar	Der Anmeldename des Benutzers, der die Sitzung geöffnet 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	Zeitpunkt, zu dem das Ereignis begonnen hat (falls vorhanden).	14	Ja
TransactionID	bigint	Die vom System zugewiesene ID der Transaktion.	4	Ja
XactSequence	bigint	Das Token zur Beschreibung der aktuellen Transaktion.	50	Ja

Weitere Informationen

Erweiterte Ereignisse
sp_trace_setevent (Transact-SQL)
Cursor