CursorOpen-Ereignisklasse
Die CursorOpen-Ereignisklasse beschreibt cursoröffnende Ereignisse, die in API-Cursorn (Application Programming Interface, Anwendungsprogrammierschnittstelle) auftreten. CursorOpen-Ereignisse treten auf, wenn SQL Server Database Engine (Datenbankmodul) die SQL-Anweisung so definiert, dass sie dem Cursor und den Cursoroptionen zugeordnet wird und anschließend den Cursor füllt.
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 hergestellt 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 gefüllt, wenn der Client die Clientprozess-ID angibt. |
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 = 53. |
27 |
Nein |
EventSequence |
int |
Die Sequenz der CursorOpen-Ereignisklasse im Batch. |
51 |
Nein |
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 gefüllt, wenn der Client den Hostnamen angibt. Der Hostname kann mithilfe der HOST_NAME-Funktion bestimmt werden. |
8 |
Ja |
IntegerData |
int |
Cursortyp. Die Werte sind: 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 |
Der Anmeldename des Benutzers (SQL Server-Sicherheitsanmeldung oder Microsoft Windows-Anmeldeinformationen im Format DOMAIN\username). |
11 |
Ja |
LoginSid |
image |
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 SQL Server-Instanz, für die eine Ablaufverfolgung ausgeführt wird. |
26 |
Nein |
SessionLoginName |
nvarchar |
Der Anmeldename des Benutzers, der die Sitzung geöffnet hat. Wenn Sie z. B. eine Verbindung mit SQL Server mithilfe von Login1 herstellen und eine Anweisung mithilfe von Login2 ausführen, zeigt SessionLoginName Login1 an, und LoginName zeigt Login2 an. Diese Spalte zeigt sowohl den SQL Server- als auch den Windows-Anmeldenamen an. |
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 |
Siehe auch
Verweis
sp_trace_setevent (Transact-SQL)