Freigeben über


CursorUnprepare-Ereignisklasse

Die CursorUnprepare-Ereignisklasse enthält Informationen zu Ereignissen, mit denen die Vorbereitung eines Cursors aufgehoben wird und die in API-Cursorn (Application Programming Interface, Schnittstelle für Anwendungsprogrammierung) auftreten. Ereignisse zur Aufhebung der Vorbereitung eines Cursors treten ein, wenn ein Ausführungsplan durch Microsoft Database Engine (Datenbankmodul) 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. Werden Cursor stark genutzt, kann die Ablaufverfolgung die Leistung deutlich beeinträchtigen.

Datenspalten in der CursorUnprepare-Ereignisklasse

Datenspaltenname

Datentyp

Beschreibung

Column ID

Filterbar

ApplicationName

nvarchar

Name der Clientanwendung, die die Verbindung mit einer Instanz von SQL Server hergestellt 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 gefü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 gefüllt, wenn der Client den Hostnamen angibt. 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. eine Verbindung mit SQL Server mithilfe von Login1 herstellen und eine Anweisung mithilfe von Login2 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

Token, das die aktuelle Transaktion beschreibt.

50

Ja

Siehe auch

Verweis

sp_trace_setevent (Transact-SQL)