CursorPrepare 이벤트 클래스CursorPrepare Event Class

CursorPrepare 이벤트 클래스는 API(응용 프로그래밍 인터페이스) 커서에서 발생하는 커서 준비 이벤트를 설명합니다.The CursorPrepare event class describes cursor prepare events that occur in application programming interface (API) cursors. 커서 준비 이벤트는 MicrosoftMicrosoft 데이터베이스 엔진Database Engine 이 커서와 연관된 SELECT 문을 실행 계획으로 컴파일하지만 커서를 만들지 않은 경우 발생합니다.Cursor prepare events occur when the MicrosoftMicrosoft 데이터베이스 엔진Database Engine compiles a SELECT statement associated with a cursor into an execution plan but does not create the cursor.

커서 성능을 기록하고 있는 추적에 CursorPrepare 이벤트 클래스를 포함시키십시오.Include the CursorPrepare event class in traces that are recording the performance of cursors. CursorPrepare 이벤트 클래스를 추적에 포함시키는 경우 발생되는 오버헤드의 양은 추적 중 데이터베이스에 대해 커서가 사용되는 빈도에 따라 달라집니다.When the CursorPrepare event class is included in a trace, the amount of overhead incurred will depend on how frequently cursors are used against the database during the trace. 커서를 광범위하게 사용할 경우 추적을 수행하면 성능이 크게 저하될 수 있습니다.If cursors are used extensively, the trace may significantly impede performance.

CursorPrepare 이벤트 클래스 데이터 열CursorPrepare Event Class Data Columns

데이터 열 이름Data column name 데이터 형식Data type 설명Description 열 IDColumn ID 필터 가능Filterable
ApplicationNameApplicationName nvarcharnvarchar SQL ServerSQL Server인스턴스에 연결한 클라이언트 응용 프로그램의 이름입니다.Name of the client application that created the connection to an instance of SQL ServerSQL Server. 이 열은 프로그램의 표시 이름이 아니라 응용 프로그램에서 전달한 값으로 채워집니다.This column is populated with the values passed by the application rather than the displayed name of the program. 1010 Yes
ClientProcessIDClientProcessID intint 클라이언트 응용 프로그램이 실행 중인 프로세스에 대해 호스트 컴퓨터가 할당한 ID입니다.ID assigned by the host computer to the process where the client application is running. 클라이언트가 클라이언트 프로세스 ID를 제공하면 이 데이터 열이 채워집니다.This data column is populated if the client process ID is provided by the client. 99 Yes
DatabaseIDDatabaseID intint USE database 문에서 지정한 데이터베이스 ID이거나, 지정한 인스턴스에 대해 USE database 문을 실행하지 않은 경우 기본 데이터베이스입니다.ID of the database specified by the USE database statement or the default database if no USE database statement has been issued for a given instance. SQL Server 프로파일러SQL Server Profiler ServerName 데이터 열이 추적에서 캡처되고 서버를 사용할 수 있으면 에 데이터베이스 이름이 표시됩니다. displays the name of the database if the ServerName data column is captured in the trace and the server is available. DB_ID 함수를 사용하여 데이터베이스의 값을 확인할 수 있습니다.Determine the value for a database by using the DB_ID function. 33 Yes
DatabaseNameDatabaseName nvarcharnvarchar 사용자 문이 실행되는 데이터베이스의 이름입니다.Name of the database in which the user statement is running. 3535 Yes
EventClassEventClass intint 기록된 이벤트 유형 = 70Type of event recorded = 70. 2727 아니요No
EventSequenceEventSequence intint 일괄 처리 내에서 CursorPrepare 이벤트 클래스의 순서입니다.Sequence of CursorPrepare event class in batch. 5151 아니요No
GroupIDGroupID intint SQL 추적 이벤트가 발생한 작업 그룹의 ID입니다.ID of the workload group where the SQL Trace event fires. 6666 Yes
HandleHandle intint 이벤트 클래스의 핸들입니다.Handle of the event class. 3333 Yes
HostNameHostName nvarcharnvarchar 클라이언트를 실행 중인 컴퓨터 이름입니다.Name of the computer on which the client is running. 클라이언트가 호스트 이름을 제공하면 이 데이터 열이 채워집니다.This data column is populated if the host name is provided by the client. 호스트 이름을 확인하려면 HOST_NAME 함수를 사용합니다.To determine the host name, use the HOST_NAME function. 88 Yes
IsSystemIsSystem intint 이벤트가 시스템 프로세스에서 발생했는지 아니면 사용자 프로세스에서 발생했는지를 나타냅니다.Indicates whether the event occurred on a system process or a user process. 1 = 시스템, 0 = 사용자1 = system, 0 = user. 6060 Yes
LoginNameLoginName nvarcharnvarchar 사용자 로그인 이름(DOMAIN\username 형식의 Windows 로그인 자격 증명 또는 SQL ServerSQL Server 보안 로그인)입니다.Name of the login of the user (either SQL ServerSQL Server security login or the Windows login credentials in the form of DOMAIN\username). 1111 Yes
LoginSidLoginSid imageimage 로그인한 사용자의 SID(보안 ID)입니다.Security identification number (SID) of the logged-in user. 이 정보는 sys.server_principals 카탈로그 뷰에 있습니다.You can find this information in the sys.server_principals catalog view. 각 SID는 서버의 각 로그인마다 고유합니다.Each SID is unique for each login in the server. 4141 Yes
NTDomainNameNTDomainName nvarcharnvarchar 사용자가 속한 Windows 도메인입니다.Windows domain to which the user belongs. 77 아니요No
NTUserNameNTUserName nvarcharnvarchar Windows 사용자 이름입니다.Windows user name. 66 Yes
RequestIDRequestID intint 커서를 준비한 요청 ID입니다.Request identification that prepared the cursor. 4949 Yes
데이터 열이 추적에서 캡처되고 서버를 사용할 수 있으면ServerName nvarcharnvarchar 추적 중인 SQL ServerSQL Server 인스턴스의 이름입니다.Name of the instance of SQL ServerSQL Server being traced. 2626 아니요No
SessionLoginNameSessionLoginName nvarcharnvarchar 세션을 시작한 사용자의 로그인 이름입니다.Login name of the user who originated the session. 예를 들어 Login1을 사용하여 SQL ServerSQL Server 에 연결하고 Login2로 문을 실행할 경우 SessionLoginName 은 Login1을 표시하고 LoginName 은 Login2를 표시합니다.For example, if you connect to SQL ServerSQL Server using Login1 and execute a statement as Login2, SessionLoginName shows Login1 and LoginName shows Login2. 이 열은 SQL ServerSQL Server 및 Windows 로그인을 모두 표시합니다.This column displays both SQL ServerSQL Server and Windows logins. 6464 Yes
SPIDSPID intint 이벤트가 발생한 세션의 ID입니다.ID of the session on which the event occurred. 1212 Yes
StartTimeStartTime datetimedatetime 사용 가능한 경우 이벤트가 시작된 시간입니다.Time at which the event started, when available. 1414 Yes
TransactionIDTransactionID bigintbigint 시스템이 할당한 트랜잭션의 ID입니다.System-assigned ID of the transaction. 44 Yes
XactSequenceXactSequence bigintbigint 현재 트랜잭션을 설명하는 토큰입니다.Token used to describe the current transaction. 5050 Yes

참고 항목See Also

확장 이벤트 Extended Events
sp_trace_setevent(Transact-SQL) sp_trace_setevent (Transact-SQL)
커서 Cursors