SET NOEXEC (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Compila cada consulta mas não a executa.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
SET NOEXEC { ON | OFF }  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Comentários

Quando SET NOEXEC está como ON, o SQL Server analisa e compila cada lote de instruções Transact-SQL, mas não as executa. Quando SET NOEXEC é OFF, todos os lotes são executados depois de compilação. NOEXEC dá suporte à resolução de nomes adiada; se um ou mais objetos referenciados no lote não existirem, nenhum erro será gerado.

A execução de instruções no SQL Server tem duas fases: compilação e execução. Esta configuração é útil para que o SQL Server valide a sintaxe e os nomes de objeto no código Transact-SQL durante a execução. Também é útil para depurar instruções que geralmente fariam parte de um lote maior de instruções.

A configuração de SET NOEXEC é definida na execução ou em tempo de execução e não no momento da análise.

Permissões

Requer associação à função public.

Exemplos

O exemplo a seguir usa NOEXEC com uma consulta válida, um consulta com um nome de objeto que não é válido e uma consulta com sintaxe incorreta.

USE AdventureWorks2022;  
GO  
PRINT 'Valid query';  
GO  
-- SET NOEXEC to ON.  
SET NOEXEC ON;  
GO  
-- Inner join.  
SELECT e.BusinessEntityID, e.JobTitle, v.Name  
FROM HumanResources.Employee AS e   
   INNER JOIN Purchasing.PurchaseOrderHeader AS poh  
   ON e.BusinessEntityID = poh.EmployeeID  
   INNER JOIN Purchasing.Vendor AS v  
   ON poh.VendorID = v.BusinessEntityID;  
GO  
-- SET NOEXEC to OFF.  
SET NOEXEC OFF;  
GO  
  
PRINT 'Invalid object name';  
GO  
-- SET NOEXEC to ON.  
SET NOEXEC ON;  
GO  
-- Function name used is a reserved keyword.  
USE AdventureWorks2022;  
GO  
CREATE FUNCTION dbo.Values(@BusinessEntityID int)  
RETURNS TABLE  
AS  
RETURN (SELECT PurchaseOrderID, TotalDue  
   FROM dbo.PurchaseOrderHeader  
   WHERE VendorID = @BusinessEntityID);  
  
-- SET NOEXEC to OFF.  
SET NOEXEC OFF;  
GO  
  
PRINT 'Invalid syntax';  
GO  
-- SET NOEXEC to ON.  
SET NOEXEC ON;  
GO  
-- Built-in function incorrectly invoked.  
SELECT *  
FROM fn_helpcollations;  
-- Reset SET NOEXEC to OFF.  
SET NOEXEC OFF;  
GO  

Consulte Também

Instruções SET (Transact-SQL)
SET SHOWPLAN_ALL (Transact-SQL)
SET SHOWPLAN_TEXT (Transact-SQL)