• Articolo

NULLIF (Transact-SQL)

Restituisce un valore Null se le due espressioni specificate sono uguali.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

NULLIF ( expression , expression )

Argomenti

Tipi restituiti

Restituisce lo stesso tipo di dati del primo argomento expression.

Se le due espressioni non sono uguali, la funzione NULLIF restituisce il primo argomento expression. Se le espressioni sono uguali, NULLIF restituisce un valore Null del tipo del primo argomento expression.

Osservazioni

NULLIF è equivalente a un'espressione CASE avanzata in cui le due espressioni sono uguali e l'espressione risultante è Null.

È consigliabile non utilizzare funzioni dipendenti dal tempo, ad esempio RAND(), in una funzione NULLIF. La funzione potrebbe essere valutata due volte e restituire risultati diversi dalle due chiamate.

Esempi

A. Restituzione degli importi del budget non modificati

Nell'esempio seguente viene creata una tabella budgets per visualizzare un reparto (dept), il relativo budget corrente (current_year) e il relativo budget precedente (previous_year). Per l'anno in corso, viene utilizzato NULL per i reparti in cui il budget dell'anno corrente è uguale a quello dell'anno precedente e 0 per i budget non ancora definiti. Per trovare la media solo dei reparti che ricevono un budget e includere inoltre il valore del budget dell'anno precedente (utilizzare il valore previous_year se current_year è NULL), vengono combinate le funzioni NULLIF e COALESCE.

USE AdventureWorks;
GO
IF OBJECT_ID ('dbo.budgets','U') IS NOT NULL
   DROP TABLE budgets;
GO
SET NOCOUNT ON;
CREATE TABLE dbo.budgets
(
   dept            tinyint   IDENTITY,
   current_year      decimal   NULL,
   previous_year   decimal   NULL
);
INSERT budgets VALUES(100000, 150000);
INSERT budgets VALUES(NULL, 300000);
INSERT budgets VALUES(0, 100000);
INSERT budgets VALUES(NULL, 150000);
INSERT budgets VALUES(300000, 250000);
GO  
SET NOCOUNT OFF;
SELECT AVG(NULLIF(COALESCE(current_year,
   previous_year), 0.00)) AS 'Average Budget'
FROM budgets;
GO

Set di risultati:

Average Budget

--------------

212500.000000

(1 row(s) affected)

B. Confronto tra NULLIF e CASE

Per illustrare la somiglianza tra NULLIF e CASE, nelle query seguenti viene determinato se i valori nelle colonne MakeFlag e FinishedGoodsFlag corrispondono. La prima query utilizza NULLIF. La seconda query utilizza l'espressione CASE.

USE AdventureWorks;
GO
SELECT ProductID, MakeFlag, FinishedGoodsFlag, 
   NULLIF(MakeFlag,FinishedGoodsFlag)AS 'Null if Equal'
FROM Production.Product
WHERE ProductID < 10;
GO

SELECT ProductID, MakeFlag, FinishedGoodsFlag,'Null if Equal' =
   CASE
       WHEN MakeFlag = FinishedGoodsFlag THEN NULL
       ELSE MakeFlag
   END
FROM Production.Product
WHERE ProductID < 10;
GO