Comment indenter SQL

Pourquoi l'indentation est importante dans SQL

SQL ignore les espaces, ce qui signifie qu'une requête peut être écrite sans aucune structure et néanmoins exécutée. C'est un piège. Sans indentation, une requête est une série de mots simples où les limites entre les clauses sont invisibles et où la relation entre une jointure et sa condition est incertaine. L'indentation restaure visuellement cette structure : elle transforme une phrase en un plan, où la forme de la mise en page reflète la forme de la logique.

Le gain est une lecture plus rapide et moins d'erreurs. Une requête bien indentée vous permet de confirmer en un coup d'œil que chaque jointure a une condition, que les filtres sont correctement regroupés et qu'une sous-requête est imbriquée là où vous pensez qu'elle se trouve.

Les règles de base

• Une clause par ligne. SELECT, FROM, WHERE, GROUP BY, HAVING et ORDER BYcommence chacun une nouvelle ligne à la marge de base.
• Indentez le corps de la clause.Les colonnes aprèsSELECT, les tables aprèsFROM, les conditions aprèsWHEREse trouvent tous à un niveau.
• Un élément par ligne dans les listes.Chaque colonne sélectionnée et chaqueWHEREobtient sa propre ligne afin que les longues listes ne défilent jamais latéralement.
• Pause sur AND et OR.En commençant chaque booléen sur une nouvelle ligne, la logique se lit comme une liste de contrôle.
• Indente les sous-requêtes plus profondément.Une requête entre parenthèses est indentée d'un niveau au-delà de son parent, l'imbrication est donc évidente.

Règles appliquées

SELECT
  c.name,
  o.total
FROM
  customers c
  JOIN orders o
  ON o.customer_id = c.id
WHERE
  o.status = 'paid'
  AND o.total > 50
ORDER BY
  o.total DESC

Chaque règle ci-dessus est visible ici : clauses en marge, corps en retrait, un élément par ligne, booléens éclatés, la jointure associée à sa condition. Il s’agit de la mise en page qu’un formateur produit automatiquement.

Laissez l'outil faire le travail

Connaître les règles est utile, mais les appliquer manuellement à une requête longue est fastidieux et sujet aux erreurs. Un formateur code toutes ces conventions et les applique en un seul passage, de manière cohérente, à chaque fois. Vous obtenez ainsi l'indentation du manuel sans compter les espaces. Collez votre requête, choisissez une indentation à deux ou quatre espaces et copiez le résultat. Il s'exécute entièrement dans votre navigateur, de sorte que même les requêtes pleines de noms internes restent privées et l'outil fonctionne sans aucune connexion.