CursorPrepare-EreignisklasseCursorPrepare 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 CursorPrepare -Ereignisklasse beschreibt cursorvorbereitende Ereignisse, die in API-Cursorn (Application Programming Interface, Anwendungsprogrammierschnittstelle) auftreten.The CursorPrepare event class describes cursor prepare events that occur in application programming interface (API) cursors. Cursorvorbereitende Ereignisse treten auf, wenn MicrosoftMicrosoft Datenbank-EngineDatabase Engine eine mit einem Cursor verknüpfte SELECT-Anweisung in einen Ausführungsplan kompiliert, jedoch den Cursor nicht erstellt.Cursor prepare events occur when the MicrosoftMicrosoft Datenbank-EngineDatabase Engine compiles a SELECT statement associated with a cursor into an execution plan but does not create the cursor.

Schließen Sie die CursorPrepare -Ereignisklasse in Ablaufverfolgungen ein, die die Leistung von Cursorn aufzeichnen.Include the CursorPrepare event class in traces that are recording the performance of cursors. 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.When the CursorPrepare 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.

Datenspalten der CursorPrepare-EreignisklasseCursorPrepare 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 die Clientprozess-ID durch den Client bereitgestellt wird.This data column is populated if the client process ID is provided by the client. 99 JaYes
DatabaseIDDatabaseID intint 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.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 = 70.Type of event recorded = 70. 2727 NeinNo
EventSequenceEventSequence intint Sequenznummer der CursorPrepare -Ereignisklasse in einem Batch.Sequence of CursorPrepare 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 Handle der Ereignisklasse.Handle of the event class. 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 durch den Client bereitgestellt wird.This data column is populated if the host name is provided by the client. Der Hostname kann mithilfe der HOST_NAME-Funktion bestimmt werden.To determine the host name, use the HOST_NAME function. 88 JaYes
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 Sicherheits-ID (SID) des angemeldeten Benutzers.Security identification number (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 NeinNo
NTUserNameNTUserName nvarcharnvarchar Windows-Benutzername.Windows user name. 66 JaYes
RequestIDRequestID intint ID der Anforderung, die den Cursor vorbereitet hat.Request identification that prepared 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 Der Zeitpunkt, zu dem das Ereignis begonnen hat (falls verfügbar).Time at which the event started, when 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