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 pública.

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 AdventureWorks;
GO
PRINT 'Valid query';
GO
-- SET NOEXEC to ON.
SET NOEXEC ON;
GO
-- Inner join.
SELECT e.EmployeeID, e.Title, v.Name
FROM HumanResources.Employee e 
   INNER JOIN Purchasing.PurchaseOrderHeader poh
   ON e.EmployeeID = poh.EmployeeID
   INNER JOIN Purchasing.Vendor v
   ON poh.VendorID = v.VendorID;
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 AdventureWorks;
GO
CREATE FUNCTION dbo.Values(@EmployeeID INT)
RETURNS TABLE
AS
RETURN (SELECT PurchaseOrderID, TotalDue
   FROM dbo.PurchaseOrderHeader
   WHERE EmployeeID = @EmployeeID)
-- 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