SET NOEXEC (Transact-SQL)

Compila cada consulta mas não a executa.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

SET NOEXEC { ON | OFF }

Comentários

Quando SET NOEXEC é ON, o SQL Server compila cada lote de instruções Transact-SQL mas não o executa. Quando SET NOEXEC é OFF, todos os lotes são executados depois de compilação.

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 na 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 AdventureWorks2008R2;
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 uses is a reserved keyword.
USE AdventureWorks2008R2;
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