La fonction NVL de MaxCompute permet de remplacer une valeur nulle dans une requête par une valeur spécifique. Elle évite ainsi l'inclusion de valeurs nulles inattendues dans les résultats lors de l'analyse des données ou de la génération de rapports. Cette rubrique décrit l'utilisation de la fonction NVL dans MaxCompute.
Syntaxe
nvl(T <value>, T <default_value>)Paramètres
value : obligatoire. Paramètre d'entrée.
Tspécifie le type des données d'entrée. Il peut s'agir de tout type de données pris en charge par MaxCompute.default_value : obligatoire. Valeur de remplacement de la valeur nulle. Le type de données de default_value doit être identique à celui de value.
Valeur de retour
Si value est nul, la fonction renvoie default_value. Sinon, elle renvoie value. Les paramètres value et default_value doivent être du même type de données.
Exemple de données
Cette section présente des exemples de données source pour illustrer l'utilisation de la fonction NVL. L'exemple suivant crée une table nommée nvl_test et y insère des données :
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);Exemples
La table nvl_test contient les colonnes suivantes : c1, c2 et c3. La fonction NVL remplace les valeurs nulles de la colonne c1 par 00000, celles de la colonne c2 par 0 et celles de la colonne c3 par un trait d'union (-). Exemple d'instruction :
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 | - |
+-----+------------+-----+Fonctions associées
Pour plus d'informations, consultez la rubrique Autres fonctions.