SQL 条件函数

InfluxDB 3 Core SQL 实现支持以下条件函数，用于有条件地处理 null 值。

• coalesce
• greatest
• ifnull
• least
• nullif
• nvl
• nvl2

coalesce

返回其参数中第一个不是 null 的值。如果所有参数都为 null，则返回 null。此函数通常用于为 null 值替换默认值。

coalesce(expression1[, ..., expression_n])

参数

• expression1, expression_n：如果先前的表达式为 null，则使用该表达式。可以是常量、列或函数，以及任何算术运算符的组合。根据需要传入任意数量的表达式参数。

SELECT
  val1,
  val2,
  val3,
  coalesce(val1, val2, val3, 'quz') AS coalesce
FROM
  (values ('foo', 'bar', 'baz'),
          (NULL, 'bar', 'baz'),
          (NULL, NULL, 'baz'),
          (NULL, NULL, NULL)
  ) data(val1, val2, val3)

greatest

返回表达式列表中最大的值。如果所有表达式都为 null，则返回 null。

greatest(expression1[, ..., expression_n])

参数

• expression1, expression_n：用于比较并返回最大值的表达式。可以是常量、列或函数，以及任何算术运算符的组合。根据需要传入任意数量的表达式参数。

SELECT time, greatest(a, b) AS greatest FROM numbers LIMIT 4

ifnull

nvl 的别名。

least

返回表达式列表中最小的值。如果所有表达式都为 null，则返回 null。

least(expression1[, ..., expression_n])

参数

• expression1, expression_n：用于比较并返回最小值的表达式。可以是常量、列或函数，以及任何算术运算符的组合。根据需要传入任意数量的表达式参数。

SELECT time, least(a, b) AS least FROM numbers LIMIT 4

nullif

如果 expression1 等于 expression2，则返回 null；否则返回 expression1。这可用于执行 coalesce 的反向操作。

nullif(expression1, expression2)

参数

• expression1：要比较并返回（如果等于 expression2）的表达式。可以是常量、列或函数，以及任何算术运算符的组合。
• expression2：要与 expression1 比较的表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT
  value,
  nullif(value, 'baz') AS nullif
FROM
  (values ('foo'),
          ('bar'),
          ('baz')
  ) data(value)

nvl

如果 expression1 为 null，则返回 expression2；否则返回 expression1。

nvl(expression1, expression2)

参数

• expression1：如果不为 null，则返回此表达式。可以是常量、列或函数，以及任何算术运算符的组合。
• expression2：如果 expression1 为 null，则返回此表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT
  value,
  nvl(value, 'baz') AS nvl
FROM
  (values ('foo'),
          ('bar'),
          (NULL)
  ) data(value)

nvl2

如果 expression1 **不** 为 null，则返回 expression2；否则返回 expression3。

nvl2(expression1, expression2, expression3)

参数

• expression1：要测试是否为 null 的第一个表达式。可以是常量、列或函数，以及任何运算符的组合。
• expression2：如果 expression1 不为 null，则返回的第二个表达式。可以是常量、列或函数，以及任何运算符的组合。
• expression3：如果 expression1 为 null，则返回的表达式。可以是常量、列或函数，以及任何运算符的组合。

SELECT
  val1,
  val2,
  val3,
  nvl2(val1, val2, val3) AS nvl2
FROM
  (values ('foo', 'bar', 'baz'),
          (NULL, 'bar', 'baz'),
          (NULL, NULL, 'baz'),
  ) data(val1, val2, val3)