ISNULL (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse no Microsoft Fabric

Substitui NULL pelo valor de substituição especificado.

Convenções de sintaxe de Transact-SQL

Sintaxe

ISNULL ( check_expression , replacement_value )

Argumentos

check_expression

A expressão a ser verificada .NULL check_expression pode ser de qualquer tipo.

replacement_value

A expressão a ser retornada se check_expression for NULL. replacement_value deve ser de um tipo que seja implicitamente convertido no tipo check_expression.

Tipos de retorno

Retorna o mesmo tipo que check_expression. Se um literal NULL for fornecido como check_expression, ISNULL retornará o tipo de dados do replacement_value. Se um literal NULL for fornecido como check_expression e nenhum replacement_value for fornecido, ISNULL retornará um int.

Comentários

O valor de check_expression será retornado se não NULLfor . Caso contrário, replacement_value será retornado depois de ser convertido implicitamente para o tipo de check_expression, se os tipos forem diferentes. replacement_value poderá ser truncado se replacement_value for maior do que check_expression.

Exemplos

Os exemplos de código do Transact-SQL deste artigo usa o banco de dados de exemplo AdventureWorks2022 ou AdventureWorksDW2022, que pode ser baixado da home page Microsoft SQL Server Samples and Community Projects.

R. Usar ISNULL com o AVG

O exemplo a seguir localiza a média do peso de todos os produtos. Ele substitui o valor 50 de todas as NULL Weight entradas na coluna da Product tabela.

USE AdventureWorks2022;
GO
SELECT AVG(ISNULL(Weight, 50))
FROM Production.Product;
GO

Veja a seguir o conjunto de resultados.

59.79

B. Usar ISNULL

O exemplo a seguir seleciona a descrição, o percentual de desconto, a quantidade mínima e a quantidade máxima para todas as ofertas especiais em AdventureWorks2022. Se a quantidade máxima para uma oferta especial específica for NULL, o MaxQty mostrado no conjunto de resultados é 0.00.

USE AdventureWorks2022;
GO
SELECT Description, DiscountPct, MinQty, ISNULL(MaxQty, 0.00) AS 'Max Quantity'
FROM Sales.SpecialOffer;
GO

Veja a seguir o conjunto de resultados.

O exemplo a seguir usa ISNULL para substituir um NULL valor para Color, pela string None.

USE AdventureWorks2022;
GO
SELECT ProductID,
    Name,
    ProductNumber,
    ISNULL(Color, 'None') AS Color
FROM Production.Product;

Este é um conjunto de resultados parcial.

C. Teste para NULL em uma cláusula WHERE

Não use ISNULL para encontrar NULL valores. Use o IS NULL em vez disso. O exemplo a seguir localiza todos os produtos que têm NULL na coluna de peso. Observe o espaço entre IS e NULL.

USE AdventureWorks2022;
GO
SELECT Name, Weight
FROM Production.Product
WHERE Weight IS NULL;
GO

Exemplos: Azure Synapse Analytics e PDW (Analytics Platform System)

D. Usar ISNULL com o AVG

O exemplo a seguir localiza a média do peso de todos os produtos em uma tabela de amostra. Ele substitui o valor 50 de todas as NULL Weight entradas na coluna da Product tabela.

-- Uses AdventureWorksDW

SELECT AVG(ISNULL(Weight, 50))
FROM dbo.DimProduct;

Veja a seguir o conjunto de resultados.

52.88

E. Usar ISNULL

O exemplo a seguir usa ISNULL para testar NULL valores na coluna MinPaymentAmount e exibir o valor 0.00 dessas linhas.

-- Uses AdventureWorks

SELECT ResellerName,
       ISNULL(MinPaymentAmount,0) AS MinimumPayment
FROM dbo.DimReseller
ORDER BY ResellerName;

Este é um conjunto de resultados parcial.

F. Use IS NULL para testar NULL em uma cláusula WHERE

O exemplo a seguir localiza todos os produtos que têm NULL na coluna Weight. Observe o espaço entre IS e NULL.

-- Uses AdventureWorksDW

SELECT EnglishProductName, Weight
FROM dbo.DimProduct
WHERE Weight IS NULL;

Conteúdo relacionado

• Expressões (Transact-SQL)
• IS NULL (Transact-SQL)
• Funções do sistema por categoria para Transact-SQL
• WHERE (Transact-SQL)
• COALESCE (Transact-SQL)