Formateur PostgreSQL
Formatez les requêtes et scripts PostgreSQL selon les règles de Postgres pour les corps de fonction entre dollars, les chaînes d’échappement E'', les identifiants entre guillemets doubles, les conversions :: et les opérateurs JSON comme ->> et @>. Les clauses comme RETURNING, ON CONFLICT et DO UPDATE SET commencent chacune sur leur propre ligne, et les chaînes, commentaires ou parenthèses non fermés sont signalés avec leur ligne et leur colonne. Conçu pour les développeurs qui lisent des migrations et des requêtes.
Foire aux questions
Quelle syntaxe PostgreSQL est comprise ?
Les chaînes standard avec apostrophes doublées, les chaînes E'' avec caractères d’échappement, les chaînes Unicode U&'', les chaînes binaires B'' et X'', les identifiants entre guillemets doubles et les paramètres $1 sont reconnus. Les chaînes entre dollars comme $$...$$ ou $body$...$body$ sont également prises en charge.
Que deviennent les corps de fonction entre dollars ?
Un corps entre dollars est conservé exactement tel qu’il a été écrit, car il s’agit d’une chaîne pour PostgreSQL. L’instruction CREATE FUNCTION qui l’entoure est formatée, mais le corps lui-même n’est pas modifié.
Les conversions et les opérateurs sont-ils conservés tels quels ?
Oui. Les casts tels que value::integer restent joints, et les opérateurs comme ->, ->>, #>, #>>, @>, <@, ?|, ?&, @@ ainsi que les opérateurs d'expression régulière ~ et ~* et leurs formes négatives ne sont jamais séparés. Dans PostgreSQL, # est un opérateur, pas un commentaire.
Quelles clauses PostgreSQL sont placées sur leur propre ligne ?
RETURNING, ON CONFLICT, DO UPDATE SET, FOR UPDATE, FOR NO KEY UPDATE, FOR SHARE et FOR KEY SHARE restent regroupées dans leurs clauses respectives. Les clauses SELECT, FROM, WHERE, GROUP BY, ORDER BY, LIMIT et OFFSET habituelles commencent aussi sur leur propre ligne.
Les commentaires sont-ils préservés ?
Oui. Les commentaires de ligne et de bloc restent en place, et les commentaires de bloc imbriqués, que PostgreSQL autorise, sont correctement lus. Les commentaires de bloc sur plusieurs lignes sont réindentés à leur nouvel emplacement.
Prend-il en charge MERGE ?
Oui. Les branches WHEN MATCHED et WHEN NOT MATCHED commencent sur de nouvelles lignes, ce qui permet de garder lisibles les instructions MERGE de la version PostgreSQL 15 et ultérieures.
La casse des mots-clés est-elle modifiée ?
Non. Les mots-clés et les identifiants conservent la casse que vous avez saisie. Les identifiants entre guillemets sont sensibles à la casse dans PostgreSQL et ne sont jamais modifiés.
Quelles erreurs sont détectées ?
Les chaînes non fermées, les identifiants entre guillemets, les chaînes entre dollars et les commentaires de bloc, ainsi que les parenthèses déséquilibrées, sont signalés avec leur ligne et leur colonne. L'outil ne vérifie ni la grammaire complète de PostgreSQL ni votre schéma.
Quelle est la taille maximale de l’entrée ?
Jusqu'à 1 MB par requête et 128 KB par instruction. Les fichiers de migration contenant de nombreuses instructions sont formatés une instruction à la fois et séparés par des lignes vides.
Puis-je choisir l’indentation ?
Oui. Utilisez 2 ou 4 espaces, ou des tabulations. Votre SQL est traité uniquement en mémoire et n'est jamais stocké.