NVL 函数从两个表达式返回一个非 NULL 值。如果 expr1expr2 的结果皆为 NULL 值,则 NVL 函数返回 NULL

语法

  1. NVL(expr1, expr2)

参数

参数说明
expr1表达式。数据类型可以是 OceanBase 内建数据类型 中的任何数据类型。
expr2表达式。数据类型可以是 OceanBase 内建数据类型中的任何数据类型。

expr1expr2 必须是相同类型,或者可以隐式转换为相同类型。如果它们不能隐式转换,则 OceanBase 返回错误。隐式转换实现如下:

  • 如果 expr1CHARNCHARNVARCHARVARCHAR2VARCHAR 字符型数据,则 OceanBase 在比较 expr1 之前将 expr2 转换为 expr1 的数据类型,并返回 expr1 字符集的 VARCHAR2
  • 如果 expr1NUMBERFLOATBINARY_FLOATBINARY_DOUBLE 数值型数据,则 OceanBase 确定哪个参数具有最高的数字优先级,隐式地将另一个参数转换为该数据类型,并返回该数据类型。

返回类型

如果 expr1expr2NULL,则返回 NULL。如果 expr1CHARNCHARNVARCHARVARCHAR2VARCHAR 字符型数据,则返回 expr1 字符集的 VARCHAR2。如果 expr1NUMBERFLOATBINARY_FLOATBINARY_DOUBLE 数值型数据,则返回 expr1 中具有最高数字优先级的数据类型。

示例

假设有一张表 EMPLOYEES,给员工姓名列 name 和佣金列 commission_pct 里面插入数据,执行以下语句:

  1. CREATE TABLE EMPLOYEES (name VARCHAR(20),commission_pct float(3));
  2. INSERT INTO EMPLOYEEs VALUES ('Baer', null);
  3. INSERT INTO EMPLOYEEs VALUES ('Bada', null);
  4. INSERT INTO EMPLOYEEs VALUES ('Boll', 0.1);
  5. INSERT INTO EMPLOYEEs VALUES ('Bates', 0.15);
  6. INSERT INTO EMPLOYEEs VALUES ('Eric', null);

查询员工的姓名和佣金,如果员工没有收到佣金,则显示 Not Applicable。执行以下语句:

  1. SELECT name, NVL(TO_CHAR(commission_pct), 'Not Applicable') commission
  2. FROM employees WHERE name LIKE 'B%' ORDER BY name;

查询结果如下:

  1. +--------------+----------------+
  2. | NAME | COMMISSION |
  3. +--------------+----------------+
  4. | Baer | Not Applicable |
  5. +--------------+----------------+
  6. | Bada | Not Applicable |
  7. +--------------+----------------+
  8. | Boll | .1 |
  9. +--------------+----------------+
  10. | Bates | .15 |
  11. +--------------+----------------+