Gebeurtenisklasse CursorOpen

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

De CursorOpen-gebeurtenisklasse beschrijft cursor open-events die voorkomen in application programming interface (API) cursors. Cursor-opengebeurtenissen treden op wanneer de SQL Server Database Engine de SQL-instructie definieert als gekoppeld aan de cursor en cursoropties, en vervolgens de cursor vult.

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

CursorOpen 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 datakolom wordt ingevuld als de client de clientproces-ID opgeeft.	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-instructieis 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 = 53.	27	Nee.
EventSequence	int	Sequentie van de CursorOpen-eventklasse in de batch.	51	Nee.
GroupID	int	Id van de workloadgroep waarin de SQL Trace-gebeurtenis wordt geactiveerd.	66	Yes
Hendel	int	Integer gebruikt door ODBC, OLE DB of DB-Library om uitvoering met de server te coördineren.	33	Yes
HostNaam	nvarchar	Naam van de computer waarop de client wordt uitgevoerd. Deze datakolom wordt ingevuld als de client de hostnaam opgeeft. Om de hostnaam te bepalen, gebruik je de functie HOST_NAME.	8	Yes
IntegerData	int	Cursortype. Waarden zijn: 1 = Keyset 2 = Dynamisch 4 = Alleen voorwaarts 8 = Statisch 16 = Snel vooruit	vijfentwintig	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 inloggegevens van de gebruiker (ofwel SQL Server-beveiligingslogin of de Microsoft Windows-inloggegevens in de vorm van DOMEIN\gebruikersnaam).	11	Yes
LoginSid	image	Beveiligingsidentificatie (SID) van de ingelogde 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	Yes
NTUserName	nvarchar	Windows-gebruikersnaam.	6	Yes
RequestID	int	Vraag om de identificatie die de cursor opende.	49	Yes
Servernaam	nvarchar	De naam van het exemplaar van SQL Server dat wordt getraceerd.	26	Nee.
SessionLoginName	nvarchar	Inlognaam van de gebruiker die de sessie is begonnen. 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	Tijdstip waarop de gebeurtenis is gestart, indien beschikbaar.	14	Yes
TransactionID	bigint	Door het systeem toegewezen id van de transactie.	4	Yes
XactSequence	bigint	Een token die de huidige transactie beschrijft.	50	Yes

Zie ook

Uitgebreide gebeurtenissen
sp_trace_setevent (Transact-SQL)
Cursors