ClickHouse/docs/es/query_language/functions/functions_for_nulls.md

Funciones para trabajar con agregados anulables

IsNull

Comprueba si el argumento es NULO.

isNull(x)

Parámetros

• x — Un valor con un tipo de datos no compuesto.

Valor devuelto

• 1 si x ser NULL.
• 0 si x no es NULL.

Ejemplo

Tabla de entrada

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

Consulta

SELECT x FROM t_null WHERE isNull(y)

┌─x─┐
│ 1 │
└───┘

isNotNull

Comprueba si el argumento es NULO.

isNotNull(x)

Parámetros:

• x — Un valor con un tipo de datos no compuesto.

Valor devuelto

• 0 si x ser NULL.
• 1 si x no es NULL.

Ejemplo

Tabla de entrada

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

Consulta

SELECT x FROM t_null WHERE isNotNull(y)

┌─x─┐
│ 2 │
└───┘

Coalesce

Comprueba de izquierda a derecha si NULL se aprobaron argumentos y devuelve el primer no-NULL argumento.

coalesce(x,...)

Parámetros:

• Cualquier número de parámetros de un tipo no compuesto. Todos los parámetros deben ser compatibles por tipo de datos.

Valores devueltos

• El primer no-NULL argumento.
• NULL si todos los argumentos son NULL.

Ejemplo

Considere una lista de contactos que pueden especificar varias formas de contactar a un cliente.

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

El mail y phone los campos son de tipo String, pero el icq campo UInt32, por lo que necesita ser convertido a String.

Obtenga el primer método de contacto disponible para el cliente de la lista de contactos:

SELECT coalesce(mail, phone, CAST(icq,'Nullable(String)')) FROM aBook

┌─name─────┬─coalesce(mail, phone, CAST(icq, 'Nullable(String)'))─┐
│ client 1 │ 123-45-67                                            │
│ client 2 │ ᴺᵁᴸᴸ                                                 │
└──────────┴──────────────────────────────────────────────────────┘

ifNull

Devuelve un valor alternativo si el argumento principal es NULL.

ifNull(x,alt)

Parámetros:

• x — El valor que se debe comprobar NULL.
• alt — El valor que devuelve la función si x ser NULL.

Valores devueltos

• Valor x, si x no es NULL.
• Valor alt, si x ser NULL.

Ejemplo

SELECT ifNull('a', 'b')

┌─ifNull('a', 'b')─┐
│ a                │
└──────────────────┘

SELECT ifNull(NULL, 'b')

┌─ifNull(NULL, 'b')─┐
│ b                 │
└───────────────────┘

nullIf

Devoluciones NULL si los argumentos son iguales.

nullIf(x, y)

Parámetros:

x, y — Valores de comparación. Deben ser tipos compatibles, o ClickHouse generará una excepción.

Valores devueltos

• NULL si los argumentos son iguales.
• El x valor, si los argumentos no son iguales.

Ejemplo

SELECT nullIf(1, 1)

┌─nullIf(1, 1)─┐
│         ᴺᵁᴸᴸ │
└──────────────┘

SELECT nullIf(1, 2)

┌─nullIf(1, 2)─┐
│            1 │
└──────────────┘

assumeNotNull

Resultados en un valor de tipo NULL para un no- Nullable si el valor no es NULL.

assumeNotNull(x)

Parámetros:

• x — El valor original.

Valores devueltos

• El valor original del-Nullable tipo, si no es NULL.
• El valor predeterminado para el-Nullable tipo si el valor original fue NULL.

Ejemplo

Considere el t_null tabla.

SHOW CREATE TABLE t_null

┌─statement─────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_null ( x Int8,  y Nullable(Int8)) ENGINE = TinyLog │
└───────────────────────────────────────────────────────────────────────────┘

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

Aplicar el assumeNotNull función a la y columna.

SELECT assumeNotNull(y) FROM t_null

┌─assumeNotNull(y)─┐
│                0 │
│                3 │
└──────────────────┘

SELECT toTypeName(assumeNotNull(y)) FROM t_null

┌─toTypeName(assumeNotNull(y))─┐
│ Int8                         │
│ Int8                         │
└──────────────────────────────┘

Acerca de Nosotros

Convierte el tipo de argumento a Nullable.

toNullable(x)

Parámetros:

• x — El valor de cualquier tipo no compuesto.

Valor devuelto

• El valor de entrada con un Nullable tipo.

Ejemplo

SELECT toTypeName(10)

┌─toTypeName(10)─┐
│ UInt8          │
└────────────────┘

SELECT toTypeName(toNullable(10))

┌─toTypeName(toNullable(10))─┐
│ Nullable(UInt8)            │
└────────────────────────────┘

Artículo Original