Classe d'événements OLEDB DataRead

La classe d'événements OLEDB DataRead intervient lorsque SQL Server appelle un fournisseur OLE DB pour les requêtes distribuées et les procédures stockées distantes. Incluez cette classe d'événements au sein des traces qui surveillent les moments où SQL Server effectue un appel de type demande de données à l'attention du fournisseur OLE DB.

Lorsque la classe OLEDB DataRead est incluse dans la trace, la surcharge système générée est élevée. Il vous est recommandé de limiter l'utilisation de cette classe d'événements aux traces qui analysent l'apparition de problèmes particuliers, durant un bref laps de temps.

Colonnes de données de la classe d'événements OLEDB DataRead

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 contient des valeurs transmises par l'application, et non pas le nom affiché du programme.

10

Oui

ClientProcessID

int

ID affecté par l'ordinateur hôte au processus dans lequel s'exécute l'application cliente. La colonne de données est remplie si le client fournit l'ID du processus 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 databasen'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

Duration

bigint

Durée nécessaire pour exécuter l'événement d'appel OLE DB.

13

Non

EndTime

datetime

Heure de fin de l'événement.

15

Oui

Error

int

Numéro d'erreur d'un événement donné. Il s'agit souvent du numéro d'erreur stocké dans l'affichage catalogue sys.messages.

31

Oui

EventClass

int

Type d'événement = 121.

27

Non

EventSequence

int

Séquence de la classe d'événements OLE DB dans le lot.

51

Non

EventSubClass

int

Type de sous-classe d'événements.

0=Démarrage

1=Terminée

21

Non

GroupID

int

ID du groupe de charges de travail où l'événement Trace SQL se déclenche.

66

Oui

HostName

nvarchar

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

8

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

LinkedServerName

nvarchar

Nom du serveur lié.

45

Oui

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

LoginSid

image

Identificateur 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

Oui

MethodName

nvarchar

Nom de la méthode appelante.

47

Non

NTDomainName

nvarchar

Domaine Windows auquel appartient l'utilisateur.

7

Oui

NTUserName

nvarchar

Nom d'utilisateur Windows.

6

Oui

ProviderName

nvarchar

Nom du fournisseur OLE DB.

46

Oui

RequestID

int

ID de la demande contenant l'instruction.

49

Oui

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

TextData

nvarchar

Paramètres envoyés et reçus au sein de l'appel OLE DB.

1

Non

TransactionID

bigint

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

4

Oui

Voir aussi

Concepts

Événements étendus

Objets OLE Automation dans Transact-SQL

Autres ressources

sp_trace_setevent (Transact-SQL)