Formateur PostgreSQL

Adapté à PostgreSQL

PostgreSQL est respectueux des normes mais ajoute plusieurs commodités qui font trébucher les formateurs naïfs. Le plus courant est le::, un raccourci Postgres pour convertir le type d'une valeur. Si un formateur traite les deux deux-points comme des signes de ponctuation distincts, il insérera des espaces et transformeracreated_at::dateen quelque chose de non valide. Cet outil reconnaît::comme un seul opérateur et maintient les moulages collés ensemble.

Il respecte également les identifiants entre guillemets, que Postgres utilise pour préserver la casse ou autoriser les mots réservés comme noms, et il comprend les fonctionnalités analytiques sur lesquelles les utilisateurs de Postgres s'appuient fortement : expressions de table communes avecWITH, fonctions de fenêtre avecOVER et PARTITION BY.

Un exemple PostgreSQL

with recent as (select id,amount,created_at::date as d from payments where created_at > now() - interval '30 days') select d,sum(amount) as total from recent group by d order by d;

vers :

WITH recent AS (
  SELECT
    id,
    amount,
    created_at::date AS d
  FROM
    payments
  WHERE
    created_at > now() - interval '30 days'
)
SELECT
  d,
  sum(amount) AS total
FROM
  recent
GROUP BY
  d
ORDER BY
  d;

Le corps du CTE est en retrait entre ses parenthèses, le::datereste intacte et la requête externe se lit proprement en dessous.

Les fonctions de la fenêtre restent lisibles

Les requêtes analytiques Postgres peuvent croître rapidement en densité, avecROW_NUMBER(), RANK()et ses amis superposés àPARTITION BY. Le formatage maintient l'appel de fonction en ligne là où il appartient tout en divisant les clauses environnantes sur leurs propres lignes, de sorte qu'une expression de fenêtre se lit comme une seule unité au lieu de se dissoudre dans un brouillard de parenthèses. Combinée à une casse cohérente des mots clés, même une requête de rapport multi-fenêtres devient quelque chose que vous pouvez examiner en toute confiance.

Privé par conception

Postgres codent souvent une véritable logique métier (règles de tarification, contrôles d'éligibilité, définitions de reporting) et les noms de tables à eux seuls peuvent en révéler beaucoup sur un système. C'est une bonne raison de ne pas les coller dans un formateur côté serveur. Celui-ci fait tout son travail dans votre navigateur, donc rien n'est transmis, rien n'est stocké et le formateur continue de fonctionner même lorsque votre réseau est éteint. Formatez librement, y compris par rapport aux schémas de production.