Fonction SQL COALESCE

COALESCE() syntax

COALESCE(value_1, value_2, ...., value_n)

La fonction COALESCE() prend en compte au moins une valeur (value_1). Il renverra la première valeur de la liste qui n'est pas nulle. 

Par exemple, il vérifiera d'abord si value_1 est nul. Si ce n'est pas le cas, il renvoie value_1. Sinon, il vérifie si value_2 est nul. Le processus se poursuit jusqu'à ce que la liste soit complète. 

COALESCE() exemples

Exemple 1 : COALESCE() une colonne avec une constante

Considérez le tableau countries avec une liste de pays et leurs fêtes nationales. Certaines journées nationales sont vides. Pour les lignes contenant des jours nationaux vides, nous pouvons les remplir avec la valeur 'Unknown'. 

La requête et le résultat sont les suivants. 

SELECT
   country_id,
   name, 
   national_day,
   COALESCE(national_day, 'Unknown') AS national_day_coalesced
FROM countries
ORDER BY country_id

Remarquez que la valeur null dans national_day est remplacée par une constante Unknown. 

Exemple 2 : COALESCE() deux colonnes

Nous disposons d'un tableau nommé products. Il contient le nom du produit et sa description. Certaines descriptions sont trop longues (plus de 60 caractères). Dans ce cas, nous remplaçons la description par le nom du produit.

La requête et le résultat sont les suivants.

SELECT DISTINCT
   product_name,
   description,
   COALESCE(
      CASE WHEN 
         LENGTH(description) >= 60 
         THEN NULL 
         ELSE description 
         END, 
      product_name) product_name_or_description
FROM products

Remarquez que la colonne product_name_or_description affiche product_name si le description est long. Dans le cas contraire, il affiche le site description.

 Exemple 3 : COALESCE() trois colonnes ou plus

Nous pouvons aller plus loin dans l'exemple 2. Supposons qu'il y ait actuellement deux exigences.

• Si la longueur du description est inférieure à 60, affichez le description.
• Sinon, vérifiez si la longueur de product_name est inférieure à 20. Si c'est le cas, nous affichons le product_name
• Sinon, affichez product

SELECT DISTINCT
   product_name,
   description,
   COALESCE(
      CASE 
         WHEN LENGTH(description) > 50
         THEN NULL
         ELSE description
      END,
   CASE 
      WHEN LENGTH(product_name) > 14
      THEN NULL
      ELSE product_name
   END,
'product') AS product_name_or_description
FROM products
ORDER BY product_name

Remarquez que la colonne product_name_or_description affiche soit product_name soit description en fonction de la longueur des colonnes product_name et description.

Exigences techniques

COALESCE() fonctionne avec SQL Server (à partir de 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse, BigQuery et Amazon RedShift.

Voir aussi

• FORMAT() Fonction SQL
• DATEDIFF() Fonction SQL
• INSERT INTO Fonction SQL
• COUNT() Fonction SQL

En savoir plus sur SQL

• Comment apprendre SQL
• Tutoriel SQL pour les débutants
• Aide-mémoire SQL