Partilhar via


SET NOCOUNT (Transact-SQL)

Impede que a mensagem que mostra a contagem do número de linhas afetadas por uma instrução Transact-SQL ou procedimento armazenado seja retornada como parte do conjunto de resultados.

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

Sintaxe

SET NOCOUNT { ON | OFF } 

Comentários

Quando SET NOCOUNT é ON, a conta não é retornada. Quando SET NOCOUNT é OFF, a conta é retornada.

A função @@ROWCOUNT é atualizada mesmo quando SET NOCOUNT é ON.

SET NOCOUNT ON evita o envio de mensagens DONE_IN_PROC ao cliente para cada instrução em um procedimento armazenado. Para procedimentos armazenados que contêm várias instruções que não retornam muitos dados reais, ou para procedimentos que contêm loops Transact-SQL, configurar SET NOCOUNT como ON pode fornecer um aumento significativo no desempenho, porque o tráfego de rede é reduzido consideravelmente.

A configuração especificada por SET NOCOUNT está em vigor 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 evita que a mensagem sobre o número de linhas afetadas seja exibida.

USE AdventureWorks2008R2;
GO
SET NOCOUNT OFF;
GO
-- Display the count message.
SELECT TOP(5)LastName
FROM Person.Person
WHERE LastName LIKE 'A%';
GO
-- SET NOCOUNT to ON to no longer display the count message.
SET NOCOUNT ON;
GO
SELECT TOP(5) LastName
FROM Person.Person
WHERE LastName LIKE 'A%';
GO
-- Reset SET NOCOUNT to OFF
SET NOCOUNT OFF;
GO

Consulte também

Referência