CursorUnprepare (Ereignisklasse)
Die CursorUnprepare-Ereignisklasse stellt Informationen zu Ereignissen bereit, mit denen die Vorbereitung eines Cursors aufgehoben wird, und die in Cursorn von Anwendungsprogrammierschnittstellen (Application Programming Interface; API) auftreten. Ereignisse zur Aufhebung der Vorbereitung eines Cursors treten ein, wenn ein Ausführungsplan durch Microsoft Datenbank-Engine 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. Falls Cursor intensiv verwendet werden, kann die Leistung durch die Ablaufverfolgung erheblich beeinträchtigt werden.
Datenspalten in der CursorUnprepare-Ereignisklasse
| Datenspaltenname | Datentyp | BESCHREIBUNG | Column ID | Filterbar |
|---|---|---|---|---|
| ApplicationName | nvarchar | Name der Clientanwendung, die die Verbindung mit einer Instanz von SQL Serverhergestellt 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 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-Anweisung angegeben wurde, bzw. die ID der Standarddatenbank, wenn für eine bestimmte Instanz keine USE-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 = 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 | Der Name des Computers, auf dem der Client ausgeführt wird. Diese Datenspalte wird aufgefüllt, wenn der Hostname vom Client bereitgestellt wird. Der Hostname kann mithilfe der HOST_NAME-Funktion bestimmt werden. | 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 | 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 | ID der Anforderung, mit der die Vorbereitung des Cursors aufgehoben 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. mit Login1 eine Verbindung zu SQL Server herstellen und mit Login2 eine Anweisung 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, das die aktuelle Transaktion beschreibt. | 50 | Ja |