NVL2

Applies to ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition

The NVL2() function checks if the first argument is NOT NULL to produce the second argument, or the third argument otherwise. It works in a similar way as CASE expression

SELECT 
  nvl2(1,    2, 3),
  nvl2(null, 2, 3);

create.select(
  nvl2(val(1)             , 2, 3),
  nvl2(val(null), 2, 3)).fetch();

The result being

+------+------+
| nvl2 | nvl2 |
+------+------+
|    2 |    3 |
+------+------+

Dialect support

This example using jOOQ:

nvl2(val(1), 2, 3)

Translates to the following dialect specific expressions:

-- ACCESS, SQLSERVER
iif(1 IS NOT NULL, 2, 3)

-- ASE, AURORA_MYSQL, AURORA_POSTGRES, COCKROACHDB, CUBRID, DB2, DERBY, FIREBIRD, HANA, INFORMIX, MARIADB, MEMSQL, MYSQL, 
-- POSTGRES, REDSHIFT, SNOWFLAKE, SQLDATAWAREHOUSE, SQLITE, SYBASE, TERADATA, VERTICA
CASE WHEN 1 IS NOT NULL THEN 2 ELSE 3 END

-- H2, HSQLDB, INGRES, ORACLE
nvl2(1, 2, 3)

(These are currently generated with jOOQ 3.15, see #10141)

The jOOQ User Manual : SQL building : Column expressions : General functions : NVL2

previous : next