NVL2fonction

Renvoie l'une des deux valeurs selon qu'une expression spécifiée est évaluée à NULL ou NOTNULL.

Syntaxe

NVL2 ( expression, not_null_return_value, null_return_value )

Arguments

expression

Expression, telle qu’un nom de colonne, à évaluer pour l’état null.

not_null_return_value

La valeur renvoyée si l'expression est évaluée à. NOT NULL La valeur not_null_return_value doit avoir le même type de données que expression ou être implicitement convertie en ce type de données.

null_return_value

La valeur renvoyée si l'expression est évaluée à. NULL La valeur null_return_value doit avoir le même type de données que expression ou être implicitement convertie en ce type de données.

Type de retour

Le type de NVL2 retour est déterminé comme suit :

• Si not_null_return_value ou null_return_value a une valeur null, le type de données de l’expression non-null est renvoyé.

Si not_null_return_value et null_return_value n’ont pas de valeur null :

• Si not_null_return_value et null_return_value ont le même type de données que le type de données renvoyé.

• Si not_null_return_value et null_return_value ont des types de données numériques distincts, le type de données numériques compatible le plus petit est renvoyé.

• Si not_null_return_value et null_return_value ont des types de données datetime distincts, un type de données d’horodatage est renvoyé.

• Si not_null_return_value et null_return_value ont des types de données de caractères distincts, le type de données not_null_return_value est renvoyé.

• Si not_null_return_value et null_return_value ont des types de données numériques et non numériques mixtes, le type de données de not_null_return_value est renvoyé.

Important

Dans les deux derniers cas où le type de données de not_null_return_value est renvoyé, null_return_value est converti implicitement en ce type de données. Si les types de données sont incompatibles, la fonction échoue.

Notes d’utilisation

DECODEfonctionpeut être utilisé de la même manière que NVL2 lorsque l'expression et les paramètres de recherche sont tous deux nuls. La différence est que pourDECODE, le retour contiendra à la fois la valeur et le type de données du paramètre de résultat. En revanche, pourNVL2, le retour aura la valeur du paramètre not_null_return_value ou null_return_value, selon ce qui est sélectionné par la fonction, mais aura le type de données not_null_return_value.

Par exemple, en supposant que column1 est NULL défini comme suit, les requêtes suivantes renverront la même valeur. Cependant, le type de données de la valeur de DECODE retour sera INTEGER et le type de données de la valeur de NVL2 retour sera le casVARCHAR.

select decode(column1, null, 1234, '2345');
select nvl2(column1, '2345', 1234);

Exemple

L’exemple suivant modifie quelques exemples de données, puis évalue les deux champs pour fournir des informations de contact aux utilisateurs :

update users set email = null where firstname = 'Aphrodite' and lastname = 'Acevedo';

select (firstname + ' ' + lastname) as name, 
nvl2(email, email, phone) AS contact_info
from users 
where state = 'WA'
and lastname  like 'A%'
order by lastname, firstname;

name			     contact_info	
--------------------+-------------------------------------------
Aphrodite Acevedo	[phone]
Caldwell Acevedo 	[e-mail]
Quinn Adams		  [e-mail]
Kamal Aguilar		[e-mail]
Samson Alexander	 [e-mail]
Hall Alford		  [e-mail]
Lane Allen		   [e-mail]
Xander Allison	   [e-mail]
Amaya Alvarado	   [e-mail]
Vera Alvarez		 [e-mail]
Yetta Anthony		[e-mail]
Violet Arnold		[e-mail]
August Ashley		[e-mail]
Karyn Austin		 [e-mail]
Lucas Ayers		  [e-mail]