Showplan Text Event Class

The Showplan Text event class occurs when Microsoft SQL Server executes an SQL statement. The information included is a subset of the information available in Showplan All, Showplan XML Statistics Profile or Showplan XML event class.

When the Showplan Text event class is included in a trace, the amount of overhead will significantly impede performance. To minimize this, limit use of this event class to traces that monitor specific problems for brief periods of time. Showplan Text will not incur as much overhead as other Showplan event classes.

When the Showplan Text event class is included in a trace, the BinaryData data column must be selected. If it is not, information for this event class will not be displayed in the trace.

Showplan Text Event Class Data Columns

Data column name

Data type

Description

Column ID

Filterable

ApplicationName

nvarchar

Name of the client application that created the connection to an instance of SQL Server. This column is populated with the values passed by the application rather than the displayed name of the program.

10

Yes

BinaryData

image

Estimated cost of the Showplan text.

2

No

ClientProcessID

int

ID assigned by the host computer to the process where the client application is running. This data column is populated if the client process ID is provided by the client.

9

Yes

DatabaseID

int

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 Profiler displays the name of the database if the ServerName data column is captured in the trace and the server is available. Determine the value for a database by using the DB_ID function.

3

Yes

DatabaseName

nvarchar

Name of the database in which the user statement is running.

35

Yes

Event Class

int

Type of Event = 96.

27

No

EventSequence

int

Sequence of a given event within the request.

51

No

HostName

nvarchar

Name of the computer on which the client is running. This data column is populated if the host name is provided by the client. To determine the host name, use the HOST_NAME function.

8

Yes

Integer Data

integer

Estimated number of rows returned.

25

Yes

IsSystem

int

Indicates whether the event occurred on a system process or a user process. 1 = system, 0 = user.

60

Yes

LineNumber

int

Displays the number of the line containing the error.

5

Yes

Login SID

bitmap

Security identification number (SID) of the logged-in user. You can find this information in the sys.server_principals catalog view. Each SID is unique for each login in the server.

41

No

LoginName

nvarchar

Name of the login of the user (either SQL Server security login or the Microsoft Windows login credentials in the form of DOMAIN\username).

11

Yes

NestLevel

int

Integer representing the data returned by @@NESTLEVEL.

29

Yes

NTDomainName

nvarchar

Windows domain to which the user belongs.

7

Yes

ObjectID

int

System-assigned ID of the object.

22

Yes

ObjectName

nvarchar

Name of the object being referenced.

34

Yes

ObjectType

int

Value representing the type of the object involved in the event. This value corresponds to the type column in sys.objects. For values, see ObjectType Trace Event Column.

28

Yes

RequestID

int

Request identification that initiated the full text query (beginning with SQL Server 2005).

49

Yes

ServerName

nvarchar

Name of the instance of SQL Server being traced.

26

No

SessionLoginName

nvarchar

Login name of the user who originated the session. For example, if you connect to SQL Server using Login1 and execute a statement as Login2, SessionLoginName shows Login1 and LoginName shows Login2. This column displays both SQL Server and Windows logins.

64

Yes

SPID

int

ID of the session on which the event occurred.

12

Yes

StartTime

datetime

Time at which the event started, if available.

14

Yes

TransactionID

bigint

System-assigned ID of the transaction.

4

Yes

XactSequence

bigint

Token used to describe the current transaction.

50

Yes

See Also

Reference

sp_trace_setevent (Transact-SQL)

Showplan All Event Class

Showplan XML Statistics Profile Event Class

Showplan XML Event Class

Concepts

Extended Events

Showplan Logical and Physical Operators Reference