Style guide SQL

— title: Style guide SQL —

Un petit guide qui indique plusieurs styles de référence pour la syntaxe SQL (création des tables, colonnes, etc.). [https://www.sqlstyle.guide/](Style guide)

Les points principaux :

Des identifiants et noms consistants

Une utilisation judicieuse des espaces, pour faciliter la lecture

Dates au format ISO 8601 YYYY-MM-DD HH:MM:SS.SSSSS et pas un truc complètement louche (au hasard: à base d'entiers …)

Eviter les redondances

Inclure des commentaires là où c'est nécessaire, dans le style C (/* */ ou préfixé de – ).

Conventions générales de nommages

Pas de mots réservés !

Longueur de 30 caractères maximum

Utilisation d'underscore là où on utiliserait intuitivement un espace

Si on utilise des abréviations, s'assurer qu'elles sont connues

Tables

Utiliser le mot collectif plutôt que le pluriel.

Ne pas utiliser de préfixes type tbl_ ou n'importe quelle notation hongroise (= on ne préfixe rien avec le type de la donnée)

Colonnes

Au singulier

Eviter id comme identifiant de la table

Eviter d'avoir une colonne qui porte le même nom que la table et vice-versa

Toujours utiliser des minuscules

Requêtes

On utilise les majuscules pour les mots réservés (SELECT, UPDATE, …)

On évite les abréviations

Et on évite les fonctions spécifiques au moteur de db s'il existe une fonction qui exécute la même chose en ANSI SQL.

Il y a d'autres informations sur l'utilisation des espaces, des indentations, les sous-requêtes, etc.

A lire