CursorPrepare-Ereignisklasse
Gilt für:
SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz
Die CursorPrepare -Ereignisklasse beschreibt cursorvorbereitende Ereignisse, die in API-Cursorn (Application Programming Interface, Anwendungsprogrammierschnittstelle) auftreten. Cursor bereiten Ereignisse vor, wenn microsoft Datenbank-Engine eine SELECT-Anweisung kompiliert, die einem Cursor zugeordnet ist, in einen Ausführungsplan, aber nicht den Cursor erstellt.
Schließen Sie die CursorPrepare -Ereignisklasse in Ablaufverfolgungen ein, die die Leistung von Cursorn aufzeichnen. Wenn die CursorPrepare -Ereignisklasse in eine Ablaufverfolgung eingeschlossen wird, hängt der dadurch entstehende Mehraufwand davon ab, wie oft Cursor während der Ablaufverfolgung für die Datenbank verwendet werden. Wenn Cursor sehr häufig verwendet werden, kann die Ablaufverfolgung die Leistung erheblich beeinträchtigen.
Datenspalten der CursorPrepare-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 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 | No |
| EventSequence | int | Sequenznummer der CursorPrepare -Ereignisklasse in einem Batch. | 51 | No |
| GroupID | int | ID der Arbeitsauslastungsgruppe, in der das SQL-Ablaufverfolgungsereignis ausgelöst wird. | 66 | Ja |
| Handle | 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 | No |
| NTUserName | nvarchar | Windows-Benutzername. | 6 | Ja |
| RequestID | int | ID der Anforderung, die den Cursor vorbereitet hat. | 49 | Ja |
| ServerName | nvarchar | Name der Instanz von SQL Server, die nachverfolgt wird. | 26 | No |
| 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 |
Weitere Informationen
Erweiterte Ereignisse
sp_trace_setevent (Transact-SQL)
Cursor