Freigeben über


CursorPrepare (Ereignisklasse)

Die CursorPrepare-Ereignisklasse beschreibt cursorvorbereitende Ereignisse, die in API-Cursorn (Application Programming Interface, Anwendungsprogrammierschnittstelle) auftreten. Cursorvorbereitende Ereignisse treten auf, wenn Microsoft SQL Server 2005-Datenbankmodul eine mit einem Cursor verknüpfte SELECT-Anweisung in einen Ausführungsplan kompiliert, jedoch den Cursor nicht erstellt.

Schließen Sie die CursorPrepare-Ereignisklasse in Ablaufverfolgungen ein, die die Leistung von Cursorn aufzeichnen. 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. Wenn Cursor sehr häufig verwendet werden, kann die Ablaufverfolgung die Leistung erheblich beeinträchtigen.

Datenspalten der CursorPrepare-Ereignisklasse

Datenspaltenname Datentyp Beschreibung Column ID Filterbar

ApplicationName

nvarchar

Der Name der Clientanwendung, die die Verbindung mit einer Instanz von SQL Server hergestellt hat. Diese Spalte wird mit den Werten aufgefüllt, die von der Anwendung übergeben werden, und nicht mit dem angezeigten Namen des Programms.

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 die Clientprozess-ID durch den Client bereitgestellt wird.

9

Ja

DatabaseID

int

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. 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 = 70.

27

Nein

EventSequence

int

Sequenznummer der CursorPrepare-Ereignisklasse in einem Batch.

51

Nein

Handle

int

Handle der Ereignisklasse.

33

Ja

HostName

nvarchar

Name des Computers, auf dem der Client ausgeführt wird. Diese Datenspalte wird aufgefüllt, wenn der Hostname durch den Client bereitgestellt wird. Der Hostname kann mithilfe der HOST_NAME-Funktion ermittelt werden.

8

Ja

IsSystem

int

Zeigt an, ob das Ereignis in einem Systemprozess oder einem Benutzerprozess aufgetreten ist. 1 = System, 0 = Benutzer.

60

Ja

LoginName

nvarchar

Anmeldename des Benutzers (Anmeldung der SQL Server-Sicherheit oder Windows-Anmeldeinformationen im Format DOMAIN\username).

11

Ja

LoginSid

image

Sicherheits-ID (SID) des angemeldeten Benutzers. Sie finden diese Informationen in der syslogins-Tabelle der master-Datenbank. Die SID ist für jede Anmeldung am Server eindeutig.

41

Ja

NTDomainName

nvarchar

Die Windows-Domäne, der der Benutzer angehört.

7

Nein

NTUserName

nvarchar

Windows-Benutzername.

6

Ja

RequestID

int

ID der Anforderung, die den Cursor vorbereitet hat.

49

Ja

ServerName

nvarchar

Name der Instanz von SQL Server, für die eine Ablaufverfolgung ausgeführt wird.

26

Nein

SessionLoginName

nvarchar

Anmeldename des Benutzers, der die Sitzung geöffnet hat. Wenn Sie beispielsweise mithilfe von Login1 eine Verbindung mit SQL Server herstellen und eine Anweisung als Login2 ausführen, zeigt SessionLoginName den Wert Login1 an und LoginName den Wert Login2. Diese Spalte zeigt sowohl den SQL Server- als auch den Windows-Anmeldenamen an.

64

Ja

SPID

int

ID der Sitzung, in der das Ereignis aufgetreten ist.

12

Ja

StartTime

datetime

Der Zeitpunkt, zu dem das Ereignis begonnen hat (falls verfügbar).

14

Ja

TransactionID

bigint

Vom System zugewiesene ID der Transaktion.

4

Ja

XactSequence

bigint

Token, das die aktuelle Transaktion beschreibt.

50

Ja

Siehe auch

Konzepte

Cursor (Datenbankmodul)

Andere Ressourcen

Überwachen von Ereignissen
sp_trace_setevent (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005