SQL函数 NVL

SQL函数 NVL

测试 NULL 并返回适当表达式的函数。

大纲

NVL(check-expression,replace-expression)

参数

• check-expression - 要计算的表达式。
• replace-expression - 如果 check-expression 为 NULL，则返回的表达式。

NVL 返回与检查表达式相同的数据类型。

描述

NVL 计算检查表达式并返回以下两个值之一：

• 如果 check-expression 为 NULL，则返回 replace-expression。
• 如果 check-expression 不为 NULL，则返回 check-expression。

参数 check-expression 和 replace-expression 可以具有任何数据类型。如果它们的数据类型不同，SQL 会将 replace-expression 转换为 check-expression 的数据类型，然后再进行比较。返回值的数据类型始终与 check-expression 的数据类型相同，除非 check-expression 为字符数据，此时返回值的数据类型为 VARCHAR2。

请注意，NVL 支持 Oracle 兼容性，并且与 ISNULL 函数相同。

日期和时间显示转换

某些检查表达式数据类型需要从逻辑模式转换为 ODBC 模式或显示模式。例如 DATE 和 TIME 数据类型。如果replace-expression的值不是同一个数据类型，这个值不能在ODBC模式或Display模式下转换，会产生SQLCODE错误：-146 for DATE data type； -147 用于 TIME 数据类型。例如，ISNULL(DOB,'nodate')不能在 ODBC 模式或 Display模式下执行；它发出%msg Error: 'nodate' is an invalid ODBC/JDBC Date value or Error: 'nodate' is an invalid DISPLAY Date value.。要在 ODBC 模式或显示模式下执行此语句，必须将值转换为适当的数据类型ISNULL(DOB,CAST('nodate' as DATE))。这导致日期 0，显示为 1840-12-31。

NULL 处理函数比较

下表显示了各种 SQL 比较函数。如果逻辑比较测试为 True（A 与 B 相同），则每个函数返回一个值，如果逻辑比较测试为 False（A 与 B 不同），则返回另一个值。这些函数允许执行 NULL 逻辑比较。不能在实际相等（或不相等）条件比较中指定 NULL。

示例

以下示例返回替换表达式 (99)，因为检查表达式为 NULL：

SELECT NVL(NULL,99) AS NullTest

99

以下示例返回检查表达式 (33)，因为检查表达式不为 NULL：

SELECT NVL(33,99) AS NullTest

33

如果 FavoriteColors 为 NULL，则以下动态 SQL 示例返回字符串“No Preference”；否则，它返回 FavoriteColors 的值：

/// d ##class(PHA.TEST.SQLFunction).Nvl()
ClassMethod Nvl()
{
    s myquery = 3
    s myquery(1) = "SELECT Name,"
    s myquery(2) = "NVL(FavoriteColors,'No Preference') AS ColorChoice "
    s myquery(3) = "FROM Sample.Person"
    s tStatement = ##class(%SQL.Statement).%New()
    s qStatus = tStatement.%Prepare(.myquery)
    s rset = tStatement.%Execute()
    d rset.%Display()
    w !,"End of data"
}

DHC-APP>d ##class(PHA.TEST.SQLFunction).Nvl()
Name    ColorChoice
yaoxin  $lb("Red","Orange","Yellow")
xiaoli  No Preference
姚鑫    No Preference
姚鑫    No Preference
姚鑫    No Preference
姚鑫    $lb("Red","Orange","Yellow","Green")
姚鑫    $lb("Red","Orange","Yellow","Green","Green")