CursorExecute-EreignisklasseCursorExecute Event Class
Anwendungsbereich:Applies to: 
SQL ServerSQL Server (alle unterstützten Versionen) SQL ServerSQL Server (all supported versions) Azure SQL-DatenbankAzure SQL DatabaseAzure SQL-DatenbankAzure SQL DatabaseSQL ServerSQL Server (alle unterstützten Versionen) SQL ServerSQL Server (all supported versions) Azure SQL-DatenbankAzure SQL DatabaseAzure SQL-DatenbankAzure SQL Database
Die CursorExecute-Ereignisklasse beschreibt Cursorausführungsereignisse, die in API-Cursorn (Application Programming Interface, Schnittstelle für Anwendungsprogrammierung) auftreten.The CursorExecute event class describes cursor execute events that occur in application programming interface (API) cursors. Cursorausführungsereignisse treten auf, wenn MicrosoftMicrosoft Datenbank-EngineDatabase Engine mithilfe des Ausführungsplans, der von einem Cursorvorbereitungsereignis erstellt wurde, einen Cursor erstellt und befüllt.Cursor execute events occur when MicrosoftMicrosoft Datenbank-EngineDatabase Engine creates and populates a cursor from the execution plan created by a cursor prepare event.
Schließen Sie die CursorExecute -Ereignisklasse in Ablaufverfolgungen ein, von denen die Leistung von Cursorn aufgezeichnet wird.Include the CursorExecute event class in traces that are recording the performance of cursors. Wenn die CursorExecute -Ereignisklasse in eine Ablaufverfolgung eingeschlossen wird, hängt der entstehende Verwaltungsaufwand davon ab, wie häufig Cursor während der Ablaufverfolgung in Bezug auf die Datenbank verwendet werden.When the CursorExecute event class is included in a trace, the amount of overhead incurred will depend on how frequently cursors are used against the database during the trace. Wenn Cursor sehr häufig verwendet werden, kann die Ablaufverfolgung die Leistung erheblich beeinträchtigen.If cursors are used extensively, the trace may significantly impede performance.
CursorExecute (Ereignisklasse-Datenspalten)CursorExecute Event Class Data Columns
| DatenspaltennameData column name | DatentypData type | BESCHREIBUNGDescription | Column IDColumn ID | FilterbarFilterable |
|---|---|---|---|---|
| ApplicationNameApplicationName | nvarcharnvarchar | Name der Clientanwendung, die die Verbindung mit einer Instanz von SQL ServerSQL Serverhergestellt hat.Name of the client application that created the connection to an instance of SQL ServerSQL Server. Diese Spalte wird mit den Werten aufgefüllt, die von der Anwendung übergeben werden, und nicht mit dem angezeigten Namen des Programms.This column is populated with the values passed by the application rather than the displayed name of the program. | 1010 | JaYes |
| ClientProcessIDClientProcessID | intint | Die ID, die der Hostcomputer dem Prozess zuweist, in dem die Clientanwendung ausgeführt wird.ID assigned by the host computer to the process where the client application is running. Diese Datenspalte wird aufgefüllt, wenn der Client die Clientprozess-ID angibt.This data column is populated if the client provides the client process ID. | 99 | JaYes |
| DatabaseIDDatabaseID | intint | 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.ID of the database specified by the USE database statement or the default database if no USE database statement has been issued for a given instance. SQL Server ProfilerSQL Server Profiler zeigt den Namen der Datenbank an, wenn die ServerName -Datenspalte in der Ablaufverfolgung aufgezeichnet wird und der Server verfügbar ist.displays the name of the database if the ServerName data column is captured in the trace and the server is available. Der Wert für eine Datenbank kann mithilfe der DB_ID-Funktion ermittelt werden.Determine the value for a database by using the DB_ID function. | 33 | JaYes |
| DatabaseNameDatabaseName | nvarcharnvarchar | Name der Datenbank, in der die Benutzeranweisung ausgeführt wird.Name of the database in which the user statement is running. | 3535 | JaYes |
| EventClassEventClass | intint | Typ des aufgezeichneten Ereignisses = 74.Type of event recorded = 74. | 2727 | NeinNo |
| EventSequenceEventSequence | intint | Sequenz der CursorExecute -Ereignisklasse im Batch.Sequence of CursorExecute event class in batch. | 5151 | NeinNo |
| GroupIDGroupID | intint | ID der Arbeitsauslastungsgruppe, in der das SQL-Ablaufverfolgungsereignis ausgelöst wird.ID of the workload group where the SQL Trace event fires. | 6666 | JaYes |
| HandleHandle | intint | Ganze Zahl, die von ODBC, OLE DB oder DB-Library zum Koordinieren der Ausführung mit dem Server verwendet wird.Integer used by ODBC, OLE DB or DB-Library to coordinate execution with the server. | 3333 | JaYes |
| HostNameHostName | nvarcharnvarchar | Der Name des Computers, auf dem der Client ausgeführt wird.Name of the computer on which the client is running. Diese Datenspalte wird aufgefüllt, wenn der Hostname vom Client bereitgestellt wird.This data column is populated if the client provides the host name. Der Hostname kann mithilfe der HOST_NAME-Funktion bestimmt werden.To determine the host name, use the HOST_NAME function. | 88 | JaYes |
| IntegerDataIntegerData | intint | Cursortyp.Cursor type. Gültige Werte:Values are: 1 = Keyset1 = Keyset 2 = Dynamisch2 = Dynamic 4 = Vorwärtscursor4 = Forward only 8 = Statisch8 = Static 16 = Schneller Vorlauf16 = Fast forward |
2525 | NeinNo |
| IsSystemIsSystem | intint | Gibt an, ob das Ereignis bei einem Systemprozess oder einem Benutzerprozess aufgetreten ist.Indicates whether the event occurred on a system process or a user process. 1 = System, 0 = Benutzer.1 = system, 0 = user. | 6060 | JaYes |
| LoginNameLoginName | nvarcharnvarchar | Anmeldename des Benutzers ( SQL ServerSQL Server -Sicherheitsanmeldung oder Windows-Anmeldeinformationen im Format DOMAIN\username).Name of the login of the user (either SQL ServerSQL Server security login or the Windows login credentials in the form of DOMAIN\username). | 1111 | JaYes |
| LoginSidLoginSid | imageimage | Die Sicherheits-ID (Security Identifier, SID) des angemeldeten Benutzers.Security identifier (SID) of the logged-in user. Diese Informationen finden Sie in der sys.server_principals -Katalogsicht.You can find this information in the sys.server_principals catalog view. Die SID ist für jede Anmeldung beim Server eindeutig.Each SID is unique for each login in the server. | 4141 | JaYes |
| NTDomainNameNTDomainName | nvarcharnvarchar | Windows-Domäne, zu der der Benutzer gehört.Windows domain to which the user belongs. | 77 | JaYes |
| NTUserNameNTUserName | nvarcharnvarchar | Windows-Benutzername.Windows user name. | 66 | JaYes |
| RequestIDRequestID | intint | Anforderungs-ID, von der der Cursor ausgeführt wurde.Request identification that executed the cursor. | 4949 | JaYes |
| ServerNameServerName | nvarcharnvarchar | Name der SQL ServerSQL Server -Instanz, für die eine Ablaufverfolgung ausgeführt wird.Name of the instance of SQL ServerSQL Server being traced. | 2626 | NeinNo |
| SessionLoginNameSessionLoginName | nvarcharnvarchar | Der Anmeldename des Benutzers, der die Sitzung gestartet hat.Login name of the user who originated the session. Wenn Sie z. B. mit Login1 eine Verbindung zu SQL ServerSQL Server herstellen und mit Login2 eine Anweisung ausführen, zeigt SessionLoginName Login1 an, und LoginName zeigt Login2 an.For example, if you connect to SQL ServerSQL Server using Login1 and execute a statement as Login2, SessionLoginName shows Login1 and LoginName shows Login2. Diese Spalte zeigt sowohl den SQL ServerSQL Server - als auch den Windows-Anmeldenamen an.This column displays both SQL ServerSQL Server and Windows logins. | 6464 | JaYes |
| SPIDSPID | intint | Die ID der Sitzung, in der das Ereignis aufgetreten ist.ID of the session on which the event occurred. | 1212 | JaYes |
| StartTimeStartTime | datetimedatetime | Zeitpunkt, zu dem das Ereignis begonnen hat (falls vorhanden).Time at which the event started, if available. | 1414 | JaYes |
| TransactionIDTransactionID | bigintbigint | Die vom System zugewiesene ID der Transaktion.System-assigned ID of the transaction. | 44 | JaYes |
| XactSequenceXactSequence | bigintbigint | Token zur Beschreibung der aktuellen Transaktion.Token used to describe the current transaction. | 5050 | JaYes |
Weitere InformationenSee Also
Erweiterte Ereignisse Extended Events
sp_trace_setevent (Transact-SQL) sp_trace_setevent (Transact-SQL)
CursorCursors