Compartilhar via


classe de evento Plan Guide Unsuccessful

Aplica-se a: SQL Server

A classe de evento Guia de Plano Malsucedido indica que o SQL Server não pôde produzir um plano de execução para uma consulta ou lote que continha um guia de plano. Em vez disso, o plano foi compilado sem usar a guia de plano. O evento dispara quando as seguintes condições forem verdadeiras:

  • O lote/módulo na definição da guia de plano corresponde ao lote que está sendo executado.

  • A consulta na definição da guia de plano corresponde à consulta que está sendo executada.

  • As dicas na definição da guia de plano, inclusive a dica USE PLAN, não foram aplicadas com sucesso à consulta. Ou seja, o plano de consulta compilado não pôde honrar as dicas especificadas e o plano foi compilado sem usar a guia de plano.

Uma guia de plano inválida poderia fazer esse evento disparar. Valide o guia de plano usado pela consulta ou lote com a função sys.fn_validate_plan_guide e corrija o erro relatado por essa função.

Esse evento está incluído no modelo de Ajuste do SQL Server Profiler.

Observação

Essa classe de evento não está disponível no Banco de Dados SQL do Azure.

Colunas de dados da classe de evento Plan Guide Unsuccessful

Nome da coluna de dados Tipo de dados Descrição ID da coluna Filtrável
ApplicationName nvarchar Nome do aplicativo cliente que criou a conexão com uma instância do SQL Server. Essa coluna é populada com os valores passados pelo aplicativo e não com o nome exibido do programa. 10 Sim
ClientProcessID int ID atribuída pelo computador host ao processo em que o aplicativo cliente está sendo executado. Essa coluna de dados será populada se o cliente fornecer a ID de processo do cliente. 9 Sim
DatabaseID int ID do banco de dados especificado pela instrução USE database ou o banco de dados padrão se nenhuma instrução USE database tiver sido emitida para uma instância especificada. O SQL Server Profiler exibirá o nome do banco de dados se a coluna de dados ServerName for capturada no rastreamento e o servidor estiver disponível. Determine o valor para um banco de dados usando a função DB_ID. 3 Sim
DatabaseName nvarchar Nome do banco de dados no qual a instrução do usuário está sendo executada. 35 Sim
EventClass int Tipo de evento = 218. 27 Não
EventSequence int A sequência de um evento específico dentro da solicitação. 51 Não
HostName nvarchar Nome do computador no qual o cliente está sendo executado. Essa coluna de dados será populada se o cliente fornecer o nome do host. Para determinar o nome do host, use a função HOST_NAME . 8 Sim
IsSystem int Indica se o evento ocorreu em um processo do sistema ou do usuário: 1 = sistema, 0 = usuário. 60 Sim
LoginName nvarchar Nome do logon do usuário (logon de segurança do SQL Server ou as credenciais de logon do Microsoft Windows na forma de DOMAIN\username). 11 Sim
LoginSid imagem Número SID (identificação de segurança) do usuário que fez logon. É possível localizar essas informações em sys.server_principals ou nas exibições de catálogo sys.sql_logins . Cada SID é exclusivo para cada logon no servidor. 41 Sim
NTDomainName nvarchar O domínio do Windows ao qual o usuário pertence. 7 Sim
NTUserName nvarchar Nome do usuário do Windows. 6 Sim
ObjectID int ID do objeto do módulo que estava sendo compilado quando a guia de plano foi aplicada. Se a guia de plano não foi aplicada a um módulo, essa coluna será definida como NULL. 22 Sim
RequestID int A ID da solicitação que contém a instrução. 49 Sim
ServerName nvarchar Nome da instância do SQL Server que está sendo rastreada. 26 Não
SessionLoginName nvarchar Nome de logon do usuário que originou a sessão. Por exemplo, se você se conectar ao SQL Server usando Login1 e executar uma instrução como Login2, SessionLoginName mostrará Login1 e LoginName mostrará Login2. Esta coluna exibe logons do SQL Server e do Windows. 64 Sim
SPID int Identificação da sessão em que ocorreu o evento. 12 Sim
StartTime datetime Hora de início do evento, se disponível. 14 Sim
TextData ntext Nome do guia de plano. 1 Sim
TransactionID bigint ID da transação atribuída pelo sistema. 4 Sim
XactSequence bigint Token que descreve a transação atual. 50 Sim

Confira também

Classe de evento Plan Guide Successful
Eventos estendidos
sp_trace_setevent (Transact-SQL)
sys.fn_validate_plan_guide (Transact-SQL)
sp_create_plan_guide (Transact-SQL)
sp_create_plan_guide_from_handle (Transact-SQL)