Accueil › SQL & bases de données › Écrire une requête qu'on relira
Écrire une requête qu'on relira
Interroger avec SELECTdebutant
Une requête est lue bien plus souvent qu'écrite — en revue de code, dans un ticket d'incident, six mois plus tard. Quatre habitudes suffisent.
Un alias par table, toutes les colonnes qualifiées.
SELECT c.nom, cmd.reference, cmd.total
FROM client c
JOIN commande cmd ON cmd.client_id = c.id
WHERE cmd.total > 100;
Des étapes nommées avec WITH plutôt qu'une pyramide de sous-requêtes :
WITH commandes_2026 AS (
SELECT * FROM commande WHERE creee_le >= DATE '2026-01-01'
),
totaux_client AS (
SELECT client_id, sum(total) AS total_annuel
FROM commandes_2026
GROUP BY client_id
)
SELECT c.nom, t.total_annuel
FROM totaux_client t
JOIN client c ON c.id = t.client_id
WHERE t.total_annuel > 1000
ORDER BY t.total_annuel DESC;
Chaque bloc se lit, se teste et se commente séparément.
Des valeurs paramétrées, jamais concaténées : WHERE id = ? côté JDBC, :id côté JPA. C'est à la fois la protection contre l'injection SQL et la condition pour que le SGBD réutilise son plan.
Un commentaire d'origine en tête des requêtes applicatives : quand une requête lente apparaît dans les logs de la base, savoir d'où elle vient fait gagner une heure.
Les termes à connaître
- CTE (WITH)
Common Table Expression : une requête nommée, définie avant le
SELECTprincipal et réutilisable dedans. Elle découpe une requête complexe en étapes lisibles.- Alias de table
Un nom court donné à une table (
FROM commande c). Obligatoire dès qu'une table apparaît deux fois, recommandé partout ailleurs pour qualifier chaque colonne.- Colonne qualifiée
c.nomplutôt quenom. Indispensable en jointure : sans qualification, une colonne portant le même nom dans deux tables provoqueERROR: column reference "nom" is ambiguous.- Requête paramétrée
Une requête où les valeurs sont passées séparément (
WHERE id = ?), jamais concaténées dans le texte SQL. C'est la protection contre l'injection SQL, et cela permet au SGBD de réutiliser son plan.- Commentaire SQL
-- jusqu'à la fin de la ligne, ou/* bloc */. Un commentaire en tête de requête applicative (nom du service, du cas d'usage) facilite énormément l'analyse des requêtes lentes côté base.- Formatage par mots-clés
Convention de mise en page : un mot-clé par ligne (
SELECT,FROM,WHERE,ORDER BY), conditions alignées. Elle rend les différences lisibles dans une revue de code.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.