Todos los productos
Search
Centro de documentos

MaxCompute:NVL

Última actualización: Sep 22, 2026

MaxCompute permite usar la función NVL para reemplazar un valor nulo en una consulta por un valor específico. De esta manera, se evita que el resultado devuelto incluya valores nulos inesperados durante el análisis de datos o la generación de reportes. En este tema se describe cómo usar la función NVL en MaxCompute.

Sintaxis

nvl(T <value>, T <default_value>)

Parámetros

  • value: obligatorio. Es el parámetro de entrada. T especifica el tipo de los datos de entrada. Este tipo puede ser cualquier tipo de dato compatible con MaxCompute.

  • default_value: obligatorio. Es el valor que se usa para reemplazar el valor nulo. El tipo de dato de default_value debe ser igual al tipo de dato de value.

Valor devuelto

Si value es nulo, se devuelve default_value. De lo contrario, se devuelve value. Los parámetros value y default_value deben tener el mismo tipo de dato.

Datos de ejemplo

En esta sección se proporcionan datos de origen de ejemplo para mostrar cómo usar la función NVL. En este ejemplo, se crea una tabla llamada nvl_test y se le agregan datos. Instrucción de ejemplo:

CREATE TABLE nvl_test (
  c1 string,
  c2 bigint, 
  c3 datetime);
  
 -- Insert data into the table.
 INSERT INTO nvl_test VALUES 
 	('aaa',23,'2024-01-11 00:00:00'),
  ('bbb',NULL,'2024-01-12 08:00:00'),
  (NULL,20,'2024-01-13 05:00:00'),
  ('ddd',25,NULL);

Ejemplos

La tabla nvl_test contiene a continuación las columnas: c1, c2 y c3. La función NVL reemplaza un valor nulo en la columna c1 por 00000, un valor nulo en la columna c2 por 0 y un valor nulo en la columna c3 por un hyphen (-). Instrucción de ejemplo:

SELECT nvl(c1,'00000'),nvl(c2,0),nvl(c3,'-') FROM nvl_test;

-- The following result is returned:
+-----+------------+-----+
| _c0 | _c1        | _c2 |
+-----+------------+-----+
| aaa | 23         | 2024-01-11 00:00:00 |
| bbb | 0          | 2024-01-12 08:00:00 |
| 00000 | 20         | 2024-01-13 05:00:00 |
| ddd | 25         | -   |
+-----+------------+-----+

Funciones relacionadas

Para obtener más información, consulte Other functions.