SQL 条件函数

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

• coalesce
• ifnull
• 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)

ifnull

nvl 的别名。

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)