CursorUnprepare-Ereignisklasse
Die CursorUnprepare-Ereignisklasse enthält Informationen zu Ereignissen, mit denen die Vorbereitung eines Cursors aufgehoben wird und die in API-Cursorn (Application Programming Interface, Schnittstelle für Anwendungsprogrammierung) auftreten. Ereignisse zur Aufhebung der Vorbereitung eines Cursors treten ein, wenn ein Ausführungsplan durch MicrosoftDatabase Engine (Datenbankmodul) verworfen wird.
Nehmen Sie die CursorUnprepare-Ereignisklasse in Ablaufverfolgungen auf, mit denen die Leistung von Cursorn verfolgt wird. Ist die CursorUnprepare-Ereignisklasse ein Bestandteil einer Ablaufverfolgung, ergibt sich der anfallende Aufwand daraus, wie häufig Cursor für die Datenbank während der Ablaufverfolgung verwendet werden. Werden Cursor stark genutzt, kann die Ablaufverfolgung die Leistung deutlich beeinträchtigen.
Datenspalten in der CursorUnprepare-Ereignisklasse
Name der Datenspalte |
Datentyp |
Beschreibung |
Column ID |
Filterbar |
|---|---|---|---|---|
ApplicationName |
nvarchar |
Der Name der Clientanwendung, die die Verbindung mit einer Instanz von SQL Server hergestellt hat. Diese Spalte wird mit den von der Anwendung übergebenen Werten und nicht mit dem angezeigten Programmnamen aufgefüllt. |
10 |
Ja |
ClientProcessID |
int |
Die ID, die vom Hostcomputer dem Prozess zugewiesen wird, in dem die Clientanwendung ausgeführt wird. Diese Datenspalte wird gefüllt, wenn der Client die Clientprozess-ID angibt. |
9 |
Ja |
DatabaseID |
int |
ID der Datenbank, die in der USE-Anweisung angegeben wurde, bzw. die ID der Standarddatenbank, wenn für eine bestimmte Instanz keine USE-Anweisung ausgegeben wurde. In SQL Server Profiler wird der Name der Datenbank angezeigt, 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 = 77. |
27 |
Nein |
EventSequence |
int |
Batchreihenfolge für die CursorUnprepare-Ereignisklasse. |
51 |
Nein |
GroupID |
int |
ID der Arbeitsauslastungsgruppe, in der das SQL-Ablaufverfolgungsereignis ausgelöst wird. |
66 |
Ja |
Handle |
Int |
Bezeichnet den vorbereiteten Handle, dessen Vorbereitung aufgehoben werden soll. |
33 |
Ja |
HostName |
nvarchar |
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 ermittelt werden. |
8 |
Ja |
IsSystem |
int |
Zeigt an, ob das Ereignis in einem Systemprozess oder einem Benutzerprozess aufgetreten ist. 1 = System, 0 = Benutzer. |
60 |
Ja |
LoginName |
nvarchar |
Anmeldename des Benutzers (Anmeldung der SQL Server-Sicherheit oder Microsoft Windows-Anmeldeinformationen im Format DOMAIN\username). |
11 |
Ja |
LoginSid |
image |
Die Sicherheits-ID (SID) des angemeldeten Benutzers. Diese Informationen finden Sie in der sys.server_principals-Katalogsicht. Die SID ist für jede Anmeldung am Server eindeutig. |
41 |
Ja |
NTDomainName |
nvarchar |
Die Windows-Domäne, der der Benutzer angehört. |
7 |
Ja |
NTUserName |
nvarchar |
Der Windows-Benutzername. |
6 |
Ja |
RequestID |
int |
ID der Anforderung, mit der die Vorbereitung des Cursors aufgehoben wurde. |
49 |
Ja |
ServerName |
nvarchar |
Name der Instanz von SQL Server, für die eine Ablaufverfolgung ausgeführt wird. |
26 |
Nein |
SessionLoginName |
nvarchar |
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 verfügbar) |
14 |
Ja |
TransactionID |
bigint |
Vom System zugewiesene ID der Transaktion. |
4 |
Ja |
XactSequence |
bigint |
Das Token zur Beschreibung der aktuellen Transaktion. |
50 |
Ja |
Siehe auch