CursorExecute-EreignisklasseCursorExecute Event Class

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL DatabaseAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure 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