Classe d'événements Plan Guide Unsuccessful

La classe d'événements Plan Guide Unsuccessful indique que SQL Server n'a pas pu produire de plan d'exécution pour une requête ou un lot qui contenait un repère de plan. En remplacement, le plan a été compilé sans utiliser le repère de plan. L'événement est déclenché lorsque les conditions suivantes sont remplies :

  • Le lot/module dans la définition de repère de plan correspond au lot exécuté.

  • La requête dans la définition de repère de plan correspond à celle en cours d'exécution.

  • Les indicateurs dans la définition de repère de plan, y compris l'indicateur USE PLAN, n'ont pas été appliqués correctement à la requête ou au lot. Autrement dit, le plan de requête compilé n'a pas pu honorer les indicateurs spécifiés et le plan a été compilé sans utiliser le repère de plan.

Un repère de plan non valide peut provoquer le déclenchement de cet événement. Validez le repère de plan utilisé par la requête ou le lot à l'aide de la fonction sys.fn_validate_plan_guide et corrigez l'erreur signalée par cette fonction.

Cet événement est inclus dans le modèle Tuning de SQL Server Profiler.

Colonnes de données de la classe d'événements Plan Guide Unsuccessful

Nom de la colonne de données

Type de données

Description

ID de colonne

Filtrable

ApplicationName

nvarchar

Nom de l'application cliente qui a créé la connexion à une instance de SQL Server. Cette colonne est remplie par des valeurs transmises par l'application et non pas du 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. Cette colonne de données est remplie si le client fournit l'ID du processus client.

9

Oui

DatabaseID

int

Identificateur 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é émise pour une instance spécifié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étermine 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

EventClass

int

Type d'événement = 218.

27

Non

EventSequence

int

Séquence d'un événement spécifique dans la requête.

51

Non

HostName

nvarchar

Nom de l'ordinateur sur lequel s'exécute le client. Cette 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 dans un processus système ou un processus utilisateur : 1 = système, 0 = utilisateur.

60

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

Numéro d'identification de sécurité (SID) de l'utilisateur connecté. Ces informations se trouvent dans les affichages catalogue sys.server_principals ou sys.sql_logins. Chaque SID est unique pour chaque connexion dans le serveur.

41

Oui

NTDomainName

nvarchar

Domaine Windows auquel appartient l'utilisateur

7

Oui

NTUserName

nvarchar

Nom d'utilisateur Windows

6

Oui

ObjectID

int

ID d'objet du module compilé lorsque le repère de plan a été appliqué. Si le repère de plan n'a pas été appliqué à un module, cette colonne a la valeur NULL.

22

Oui

RequestID

int

ID de la demande contenant l'instruction.

49

Oui

ServerName

nvarchar

Nom de l'instance SQL Server tracée.

26

Non

SessionLoginName

nvarchar

Nom de connexion de l'utilisateur qui a créé la session. Par exemple, si vous vous connectez à SQL Server en utilisant le nom Connexion1 et que vous exécutez une instruction en tant que Connexion2, SessionLoginName affiche Connexion1 et LoginName, Connexion2. 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

ntext

Nom du repère de plan.

1

Oui

TransactionID

bigint

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

4

Oui

XactSequence

bigint

Jeton décrivant la transaction en cours.

50

Oui