Gebeurtenisklasse CursorPrepare

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

De CursorPrepare event class beschrijft cursor prepare-events die voorkomen in application programming interface (API) cursors. Cursor prepare events vinden plaats wanneer de Microsoft Database Engine een SELECT-instructie die aan een cursor is gekoppeld compileert in een uitvoeringsplan, maar de cursor niet aanmaakt.

Neem de CursorPrepare eventklasse op in traces die de prestaties van cursors registreren. Wanneer de CursorPrepare eventklasse in een trace wordt opgenomen, hangt de hoeveelheid overhead af van hoe vaak cursors worden gebruikt tegen de database tijdens de trace. Als cursors veel worden gebruikt, kan de trace de prestaties aanzienlijk belemmeren.

CursorPrepare Event Class Datakolommen

Naam van gegevenskolom	Gegevenstype	Description	Kolom-id	Filterbaar
ApplicationName	nvarchar	Naam van de clienttoepassing die de verbinding met een exemplaar van SQL Server heeft gemaakt. Deze kolom wordt gevuld met de waarden die door de toepassing worden doorgegeven in plaats van de weergegeven naam van het programma.	10	Yes
ClientProcessID	int	De id die door de hostcomputer is toegewezen aan het proces waarop de clienttoepassing wordt uitgevoerd. Deze gegevenskolom wordt ingevuld als de clientproces-id wordt opgegeven door de client.	9	Yes
DatabaseID	int	ID van de database die door de USE-database-instructie wordt gespecificeerd, of de standaarddatabase, als er voor een bepaalde instantie geen USE-database-instructie is uitgegeven. SQL Server Profiler toont de naam van de database als de ServerName-datakolom in de trace wordt vastgelegd en de server beschikbaar is. Bepaal de waarde voor een database met behulp van de functie DB_ID.	3	Yes
DatabaseName-	nvarchar	Naam van de database waarin de gebruikersinstructie wordt uitgevoerd.	35	Yes
EventClass	int	Type geregistreerd evenement = 70.	27	Nee.
EventSequence	int	Sequence van de CursorPrepare event class in batch.	51	Nee.
GroupID	int	Id van de workloadgroep waarin de SQL Trace-gebeurtenis wordt geactiveerd.	66	Yes
Hendel	int	Beheerder van de eventklasse.	33	Yes
HostNaam	nvarchar	Naam van de computer waarop de client wordt uitgevoerd. Deze gegevenskolom wordt ingevuld als de hostnaam wordt opgegeven door de client. Om de hostnaam te bepalen, gebruik je de functie HOST_NAME.	8	Yes
IsSystem	int	Geeft aan of de gebeurtenis heeft plaatsgevonden in een systeemproces of een gebruikersproces. 1 = systeem, 0 = gebruiker.	60	Yes
LoginNaam	nvarchar	Naam van de inlog van de gebruiker (ofwel SQL Server beveiligingslogin of de Windows-inloggegevens in de vorm van DOMEIN\gebruikersnaam).	11	Yes
LoginSid	image	Beveiligingsidentificatienummer (SID) van de aangemelde gebruiker. Je kunt deze informatie vinden in de catalogusweergave van de sys.server_principals . Elke SID is uniek voor elke aanmelding op de server.	41	Yes
NTDomainName	nvarchar	Windows-domein waartoe de gebruiker behoort.	7	Nee.
NTUserName	nvarchar	Windows-gebruikersnaam.	6	Yes
RequestID	int	Vraag om identificatie die de cursor heeft voorbereid.	49	Yes
Servernaam	nvarchar	De naam van het exemplaar van SQL Server dat wordt getraceerd.	26	Nee.
SessionLoginName	nvarchar	Aanmeldingsnaam van de gebruiker die de sessie heeft gestart. Als je bijvoorbeeld verbinding maakt met SQL Server via Login1 en een instructie uitvoert als Login2, toont SessionLoginName Login1 en LoginName Login2 . In deze kolom worden zowel SQL Server- als Windows-aanmeldingen weergegeven.	64	Yes
SPID	int	Id van de sessie waarop de gebeurtenis heeft plaatsgevonden.	12	Yes
StartTime	datetime	Tijd waarop het evenement begon, wanneer beschikbaar.	14	Yes
TransactionID	bigint	Door het systeem toegewezen id van de transactie.	4	Yes
XactSequence	bigint	Token dat wordt gebruikt om de huidige transactie te beschrijven.	50	Yes

Zie ook

Uitgebreide gebeurtenissen
sp_trace_setevent (Transact-SQL)
Cursors