NULLIF (Transact-SQL)

Artikel
03/11/2014

Gibt einen NULL-Wert zurück, wenn die beiden angegebenen Ausdrücke gleich sind.

Gilt für: SQL Server (SQL Server 2008 bis aktuelle Version), Windows Azure SQL-Datenbank (Ursprüngliche Version bis aktuelle Version).

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

NULLIF ( expression , expression )

Argumente

expression
Ein gültiger Skalarausdruck.

Rückgabetypen

Gibt denselben Typ wie der erste expression-Parameter zurück.

NULLIF gibt den ersten expression-Parameter zurück, wenn die beiden Ausdrücke nicht gleich sind. Wenn die Ausdrücke gleich sind, gibt NULLIF einen NULL-Wert vom Typ des ersten expression-Parameters zurück.

Hinweise

NULLIF entspricht einem komplexen CASE-Ausdruck, in dem die beiden Ausdrücke gleich sind und der sich ergebende Ausdruck NULL ist.

Es empfiehlt sich nicht, zeitabhängige Funktionen wie RAND() innerhalb einer NULLIF-Funktion zu verwenden. Dies könnte dazu führen, dass die Funktion zweimal ausgewertet wird und dass sie aus den beiden Aufrufen unterschiedliche Ergebnisse zurückgibt.

Beispiele

A.Zurückgeben von Budgetsummen, die sich nicht geändert haben

Im folgenden Beispiel wird eine budgets-Tabelle erstellt, die eine Abteilung (dept), ihr aktuelles Jahresbudget (current_year) und ihr Budget vom Vorjahr (previous_year) anzeigt. Für das laufende Jahr wird NULL verwendet, wenn sich das Budget einer Abteilung gegenüber dem Vorjahr nicht verändert hat. Der Wert 0 wird verwendet, wenn das Budget noch nicht festgelegt wurde. Wenn Sie nur für die Abteilungen, die ein Budget erhalten, den Durchschnittswert ermitteln und außerdem die Budgethöhe des vergangenen Jahres einschließen möchten (d. h., wenn Sie den Wert von previous_year verwenden möchten, in dem der Wert für current_year gleich NULL ist), kombinieren Sie die Funktionen NULLIF und COALESCE.

USE AdventureWorks2012;
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

Dies ist das Resultset.

Average Budget

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

212500.000000

(1 row(s) affected)

B.Vergleichen von NULLIF und CASE

Als Beispiel für die Ähnlichkeit von NULLIF und CASE wird in den folgenden Abfragen ausgewertet, ob die Werte in den Spalten MakeFlag und FinishedGoodsFlag gleich sind. In der ersten Abfrage wird NULLIF verwendet. In der zweiten Abfrage wird der CASE-Ausdruck verwendet.

USE AdventureWorks2012;
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