slug: /zh/sql-reference/functions/functions-for-nulls

Nullable处理函数 {#nullablechu-li-han-shu}

isNull {#isnull}

检查参数是否为NULL。

  1. isNull(x)

参数

  • x — 一个非复合数据类型的值。

返回值

  • 1 如果x为NULL。
  • 0 如果x不为NULL。

示例

存在以下内容的表

  1. ┌─x─┬────y─┐
  2. │ 1 │ ᴺᵁᴸᴸ │
  3. │ 2 │    3 │
  4. └───┴──────┘

对其进行查询

  1. :) SELECT x FROM t_null WHERE isNull(y)
  3. SELECT x
  4. FROM t_null
  5. WHERE isNull(y)
  7. ┌─x─┐
  8. │ 1 │
  9. └───┘
  11. 1 rows in set. Elapsed: 0.010 sec.

isNotNull {#isnotnull}

检查参数是否不为 NULL.

  1. isNotNull(x)

参数:

  • x — 一个非复合数据类型的值。

返回值

  • 0 如果x为NULL。
  • 1 如果x不为NULL。

示例

存在以下内容的表

  1. ┌─x─┬────y─┐
  2. │ 1 │ ᴺᵁᴸᴸ │
  3. │ 2 │    3 │
  4. └───┴──────┘

对其进行查询

  1. :) SELECT x FROM t_null WHERE isNotNull(y)
  3. SELECT x
  4. FROM t_null
  5. WHERE isNotNull(y)
  7. ┌─x─┐
  8. │ 2 │
  9. └───┘
  11. 1 rows in set. Elapsed: 0.010 sec.

合并 {#coalesce}

检查从左到右是否传递了«NULL»参数并返回第一个非'NULL参数。

  1. coalesce(x,...)

参数:

  • 任何数量的非复合类型的参数。所有参数必须与数据类型兼容。

返回值

  • 第一个非’NULL`参数。
  • NULL，如果所有参数都是’NULL`。

示例

考虑可以指定多种联系客户的方式的联系人列表。

  1. ┌─name─────┬─mail─┬─phone─────┬──icq─┐
  2. │ client 1 │ ᴺᵁᴸᴸ │ 123-45-67 │  123 │
  3. │ client 2 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ      │ ᴺᵁᴸᴸ │
  4. └──────────┴──────┴───────────┴──────┘

mail和phone字段是String类型，但icq字段是UInt32，所以它需要转换为String。

从联系人列表中获取客户的第一个可用联系方式：

  1. :) SELECT coalesce(mail, phone, CAST(icq,'Nullable(String)')) FROM aBook
  3. SELECT coalesce(mail, phone, CAST(icq, 'Nullable(String)'))
  4. FROM aBook
  6. ┌─name─────┬─coalesce(mail, phone, CAST(icq, 'Nullable(String)'))─┐
  7. │ client 1 │ 123-45-67                                            │
  8. │ client 2 │ ᴺᵁᴸᴸ                                                 │
  9. └──────────┴──────────────────────────────────────────────────────┘
  11. 2 rows in set. Elapsed: 0.006 sec.

ifNull {#ifnull}

如果第一个参数为«NULL»，则返回第二个参数的值。

  1. ifNull(x,alt)

参数:

  • x — 要检查«NULL»的值。
  • alt — 如果x为’NULL`，函数返回的值。

返回值

  • 价值 x，如果 x 不是 NULL.
  • 价值 alt，如果 x 是 NULL.

示例

  1. SELECT ifNull('a', 'b')
  3. ┌─ifNull('a', 'b')─┐
  4. │ a                │
  5. └──────────────────┘
  7. SELECT ifNull(NULL, 'b')
  9. ┌─ifNull(NULL, 'b')─┐
  10. │ b                 │
  11. └───────────────────┘

nullIf {#nullif}

如果参数相等，则返回NULL。

  1. nullIf(x, y)

参数:

x, y — 用于比较的值。 它们必须是类型兼容的，否则将抛出异常。

返回值

  • 如果参数相等，则为NULL。
  • 如果参数不相等，则为x值。

示例

  1. SELECT nullIf(1, 1)
  3. ┌─nullIf(1, 1)─┐
  4. │         ᴺᵁᴸᴸ │
  5. └──────────────┘
  7. SELECT nullIf(1, 2)
  9. ┌─nullIf(1, 2)─┐
  10. │            1 │
  11. └──────────────┘

assumeNotNull {#assumenotnull}

将可为空类型的值转换为非Nullable类型的值。

  1. assumeNotNull(x)

参数：

  • x — 原始值。

返回值

  • 如果x不为NULL，返回非Nullable类型的原始值。
  • 如果x为NULL，返回对应非Nullable类型的默认值。

示例

存在如下t_null表。

  1. SHOW CREATE TABLE t_null
  3. ┌─statement─────────────────────────────────────────────────────────────────┐
  4. │ CREATE TABLE default.t_null ( x Int8,  y Nullable(Int8)) ENGINE = TinyLog │
  5. └───────────────────────────────────────────────────────────────────────────┘
  7. ┌─x─┬────y─┐
  8. │ 1 │ ᴺᵁᴸᴸ │
  9. │ 2 │    3 │
  10. └───┴──────┘

将列y作为assumeNotNull函数的参数。

  1. SELECT assumeNotNull(y) FROM t_null
  3. ┌─assumeNotNull(y)─┐
  4. │                0 │
  5. │                3 │
  6. └──────────────────┘
  8. SELECT toTypeName(assumeNotNull(y)) FROM t_null
  10. ┌─toTypeName(assumeNotNull(y))─┐
  11. │ Int8                         │
  12. │ Int8                         │
  13. └──────────────────────────────┘

可调整 {#tonullable}

将参数的类型转换为Nullable。

  1. toNullable(x)

参数：

  • x — 任何非复合类型的值。

返回值

  • 输入的值，但其类型为Nullable。

示例

  1. SELECT toTypeName(10)
  3. ┌─toTypeName(10)─┐
  4. │ UInt8          │
  5. └────────────────┘
  7. SELECT toTypeName(toNullable(10))
  9. ┌─toTypeName(toNullable(10))─┐
  10. │ Nullable(UInt8)            │
  11. └────────────────────────────┘

来源文章