Manual:Coding conventions/Database/fr

Cette page décrit les conventions de codage' utilisées dans les fichiers de la MediaWiki codebase écrite pour utilisation avec une base de données. Voir aussi les general conventions qui s’appliquent à tous les langages de programmes, y compris ceux des bases de données. Si vous souhaitez une courte liste de contrôle pour vous aider à revoir vos commits, essayez d’utiliser le.

MySQL/MariaDB
Utilisez UPPERCASE pour les mots clés MySQL/MariaDB, et lowercase pour des choses comme les types. Ne spécifiez pas la longueur des types numériques, mais faites le pour les types et. Utilisez pour tous les timestamps et analysez-les au format standard en utilisant ; n’utilisez pas le type de champ.

Assurez-vous d’inclure le commentaire immédiatement avant n’importe quel nom de table; ceci sera remplacé par le préfixe de base de données du wiki si nécessaire, et l’oublier provoquera des problemes. De même, inclure le commentaire après toute déclaration de table, et  immédiatement avant tout nom d’index.

Créez des indices comme des instructions séparées, ne les incluez pas dans la requête de création de table; la syntaxe séparée est plus claire et permet de voir plus facilement la différence entre les indices uniques et non uniques. Ne créez pas d’indices avec, utilisez toujours à la place.

Toutes les nouvelles tables doivent avoir un, de préférence un simple ID.

SQLite
SQLite utilise le même SQL que MySQL/MariaDB, donc le SQL doit être compatible avec les deux. Habituellement cela peut être réalisé à l'aide de quelques règles simples qui sont données à la section Compatibilité SQLite.

Nommage des tableaux

 * Les noms de table doivent être des noms singuliers :,  ,  , etc. Il y a quelques exceptions historiques :  ,   …
 * Les noms de colonnes reçoivent un préfixe dérivé du nom de la table: le nom lui-même s’il est court, ou une abréviation:

Modifier le schema
Voir Development policy#Database_patches, surtout Special:Diff/537762/prev.

Lors de la mise à jour du schéma pour une extension, il est conseillé de mettre à jour le fichier de schéma d’origine et de créer un fichier correctif pour ceux qui mettent à jour à partir d’une version précédente.