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)