CursorUnprepare (Ereignisklasse)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

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

Weitere Informationen

sp_trace_setevent (Transact-SQL)