SET NOEXEC (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Compila cada consulta, mas não a executa.

Transact-SQL convenções de sintaxe

Sintaxe

  
SET NOEXEC { ON | OFF }  

Observações

Quando o SET NOEXEC está LIGADO, o SQL Server analisa e compila cada lote de instruções Transact-SQL, mas não as executa. Quando o SET NOEXEC está DESLIGADO, todos os lotes são executados após a compilação. O NOEXEC suporta resolução de nomes diferida; Se um ou mais objetos referenciados no lote não existirem, não será lançado erro.

A execução de instruções no SQL Server tem duas fases: compilação e execução. Esta configuração é útil para o SQL Server validar a sintaxe e os nomes dos objetos 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 definição de SET NOEXEC é definida em tempo de execução ou execução e não em tempo de análise.

Permissions

Requer a participação na função pública.

Examples

O exemplo seguinte utiliza NOEXEC com uma consulta válida, uma 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  

Ver também

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