Classe d'événements Showplan Text

La classe d'événements Showplan Text intervient quand Microsoft SQL Server exécute une instruction SQL. Les informations incluses constituent un sous-ensemble des informations disponibles dans la classe d'événements Showplan All, Showplan XML Statistics Profile ou Showplan XML.

Lorsque la classe d'événements Showplan Text est incluse dans une trace, la charge de gestion induite compromet les performances de façon significative. Pour limiter ce problème, n'utilisez cette classe d'événements qu'avec les traces surveillant des problèmes spécifiques pendant de brèves périodes. Showplan Text ne mobilise pas autant de ressources système que les autres classes d'événements Showplan.

Si vous incluez la classe d'événements Showplan Text dans une trace, la colonne de données BinaryData doit être sélectionnée. Dans le cas contraire, les informations de cette classe ne seront pas affichées dans la trace.

Colonnes de données de la classe d'événements Showplan Text

Nom de la colonne de données

Type de données

Description

ID de la colonne

Filtrable

ApplicationName

nvarchar

Nom de l'application cliente qui a créé la connexion à une instance de SQL Server. Cette colonne est remplie avec les valeurs passées par l'application plutôt que par le nom affiché du programme.

10

Oui

BinaryData

image

Coût estimé du texte Showplan.

2

Non

ClientProcessID

int

ID affecté par l'ordinateur hôte au processus dans lequel s'exécute l'application cliente. Cette colonne de données est remplie si l'ID du processus du client est fourni par le client.

9

Oui

DatabaseID

int

ID de la base de données spécifiée par l'instruction USE database ou celui de la base de données par défaut si aucune instruction USE database n'a été spécifiée pour une instance donnée. Le SQL Server Profiler affiche le nom de la base de données si la colonne de données ServerName est capturée dans la trace et que le serveur est disponible. Déterminez la valeur pour une base de données à l'aide de la fonction DB_ID.

3

Oui

DatabaseName

nvarchar

Nom de la base de données dans laquelle l'instruction de l'utilisateur est exécutée.

35

Oui

Event Class

int

Type d'événement = 96

27

Non

EventSequence

int

Séquence d'un événement donné au sein de la demande.

51

Non

HostName

nvarchar

Nom de l'ordinateur sur lequel le client est exécuté. Cette colonne de données est remplie si le nom de l'hôte est fourni par le client. Pour déterminer le nom de l'hôte, utilisez la fonction HOST_NAME.

8

Oui

Integer Data

integer

Estimation du nombre de lignes retournées

25

Oui

IsSystem

int

Indique si l'événement s'est produit sur un processus système ou sur un processus utilisateur. 1 = système, 0 = utilisateur.

60

Oui

LineNumber

int

Affiche le numéro de la ligne qui contient l'erreur.

5

Oui

Login SID

bitmap

Numéro d'identification de sécurité (SID) de l'utilisateur connecté. Vous pouvez trouver ces informations dans l'affichage catalogue sys.server_principals. Chaque connexion possède un SID unique au niveau du serveur.

41

Non

LoginName

nvarchar

Nom de la connexion de l'utilisateur (soit la connexion de sécurité SQL Server, soit les informations d'identification de connexion Microsoft Windows au format DOMAINE\nom_utilisateur).

11

Oui

NestLevel

int

Entier représentant les données retournées par @@NESTLEVEL.

29

Oui

NTDomainName

nvarchar

Domaine Windows auquel appartient l'utilisateur.

7

Oui

ObjectID

int

ID affecté à l'objet par le système.

22

Oui

ObjectName

nvarchar

Nom de l'objet référencé.

34

Oui

ObjectType

int

Valeur représentant le type de l'objet qui intervient dans l'événement. Cette valeur correspond à la colonne type dans sys.objects. Pour obtenir des valeurs, consultez Colonne d'événements de trace ObjectType.

28

Oui

RequestID

int

Identification de la demande à l'origine de la requête de texte intégral (à compter de SQL Server 2005).

49

Oui

ServerName

nvarchar

Nom de l'instance SQL Server tracée.

26

Non

SessionLoginName

nvarchar

Nom de connexion de l'utilisateur à l'origine de la session. Exemple : si vous vous connectez à SQL Server en utilisant le nom d'utilisateur Login1 et exécutez une instruction sous le nom Login2, SessionLoginName retourne Login1 et LoginName retourne Login2. Cette colonne affiche les noms de connexion SQL Server et Windows.

64

Oui

SPID

int

ID de la session au cours de laquelle l'événement s'est produit.

12

Oui

StartTime

datetime

Heure à laquelle a débuté l'événement, si elle est connue.

14

Oui

TransactionID

bigint

ID affecté par le système à la transaction.

4

Oui

XactSequence

bigint

Jeton utilisé pour décrire la transaction en cours.

50

Oui

Voir aussi

Concepts

Événements étendus

Guide de référence des opérateurs Showplan logiques et physiques

Autres ressources

sp_trace_setevent (Transact-SQL)

Classe d'événements Showplan All

Classe d'événements Showplan XML Statistics Profile

Classe d'événements Showplan XML