SQL-Formatter et Minificateur – Documentation complète, Bonnes pratiques et Intégrations

Avatar
Manuel Schulz · 18.10.2025 · Développement · 20–25 min

Le Zerlo SQL-Formatter et Minificateur rend le SQL immédiatement lisible (Rendre lisible) ou compact (Minifier). Vous contrôlez Indent (2/4/8 espaces), Keyword-Case (MAJUSCULE/minuscules/Conserver) et dans la section Avancé Suppression des commentaires ainsi que Forcer le point-virgule. Via Accès rapide des extraits d'exemples sont disponibles, et avec Auto-test vous vérifiez le comportement en quelques secondes. La page est accessible ici: zerlo.net/formattersql.

Contenu

  1. Démarrage rapide
  2. Aperçu des fonctions
  3. Exemples d'accès rapide (cas d'utilisation)
  4. Options avancées (Détails et pièges)
  5. Catégories d'applications typiques (12 scénarios)
  6. Intégration : site Web, iFrame, Teams
  7. API JSON optionnelle (avec des exemples)
  8. Auto-test (étape par étape)
  9. Conseils pro, performance et sécurité
  10. Conseils sur les dialectes et limites
  11. Dépannage & FAQ
  12. Essayer maintenant

1) Démarrage rapide

  1. Ouvre zerlo.net/formattersql.
  2. Colle ton SQL à gauche ou tape-le.
  3. Choisis le Mode: Rendre lisible (lisible) ou Minifier (compact).
  4. Définis Indentation (2/4/8) et Casse des mots-clés (UPPER/lower/Preserve) pour..
  5. Optionnel: Supprimer les commentaires, Forcer le point-virgule.
  6. Clique Formater – – le résultat apparaît à droite, y compris. Copier et Enregistrer au format .sql.
  7. Dans Auto-test tu peux tester automatiquement les règles les plus importantes..

2) Fonctions en aperçu

3) Exemples d'accès rapide (cas d'utilisation)

Ces exemples couvrent les motifs les plus courants et sont idéaux comme point de départ.

1_einfaches_select.sql
SELECT id, name FROM products WHERE status = 'active';
2_join_mit_aggregat.sql
SELECT c.id, c.title, COUNT(p.id) AS products
FROM categories c
LEFT JOIN products p ON p.category_id = c.id
GROUP BY c.id, c.title
ORDER BY products DESC;
3_case_plus_subquery.sql
SELECT u.id, u.email,
  CASE
WHEN o.total >= 1000 THEN 'gold'
WHEN o.total >= 200  THEN 'silver'
ELSE 'bronze'
  END AS tier
FROM users u
LEFT JOIN LATERAL (
  SELECT SUM(total) AS total
  FROM orders
  WHERE user_id = u.id
) o ON TRUE;
4_cte_plus_window.sql
WITH ranked AS (
  SELECT id, customer_id, total,
ROW_NUMBER() OVER (PARTITION BY customer_id ORDER BY total DESC) AS rn
  FROM orders
)
SELECT * FROM ranked WHERE rn = 1;
5_insert_returning.sql
INSERT INTO users(email, role)
VALUES ('[email protected]', 'editor')
RETURNING id, email;
6_update_mit_case.sql
UPDATE accounts
SET status = CASE
  WHEN balance < 0 THEN 'overdue'
  WHEN balance = 0 THEN 'zero'
  ELSE 'ok'
END
WHERE active = 1;
7_delete_plus_exists.sql
DELETE FROM sessions s
WHERE EXISTS (
  SELECT 1 FROM users u
  WHERE u.id = s.user_id AND u.deleted_at IS NOT NULL
);

4) Options avancées (Détails et pièges)

5) Catégories d'applications typiques (12 scénarios)

  1. Révisions de code :: Une mise en page homogène accélère les revues et évite les discussions de style.
  2. Diagnostic :: Les JOIN/CASE complexes deviennent immédiatement visuels et lisibles.
  3. Échange de connaissances :: SQL lisible pour Wiki/Confluence/README.
  4. Migrations et scripts :: Sécurité du point-virgule, blocs clairs et uniques.
  5. Intégration API :: Minifier + suppression des commentaires pour intégrer le SQL dans les apps/services.
  6. BI/Reporting :: Nettoyer les requêtes issues d'outils BI avant de les partager.
  7. Apprentissage et formation :: Afficher de manière structurée les CTE et les fonctions de fenêtre.
  8. Refactorisation :: D'abord le rendu lisible, puis isolation/optimisation des sous-parties.
  9. Reproduction d'erreurs :: Requêtes clairement structurées pour les tickets de support.
  10. Application du guide de style :: Appliquer de manière cohérente les standards d'équipe (Indent/Case).
  11. Modèles :: „Accès rapide“ comme base pour de nouvelles requêtes.
  12. Préparation de la version :: Minifier pour des artefacts stables et transportables..

6) Intégration dans Site Web/Teams

A) Utilisation directe

Voici l'outil : zerlo.net/formattersql

B) Intégration iFrame (Intranet/Backoffice)

embed_iframe.html
<iframe src="https://zerlo.net/formattersql" title="SQL Formatter" width="100%" height="900" style="border:0; border-radius:12px;"></iframe>

C) Guide de style d'équipe (base)

7) API JSON optionnelle

Vous pouvez automatiser le formatage dans les outils/CI/CD. Un exemple concis :

api_request.http
POST https://zerlo.net/formattersql?api=1
Content-Type: application/json

{
  "sql": "select id,name from users where id=1",
  "mode": "beautify",
  "options": { "indent": 4, "keywordCase": "upper", "stripComments": false, "ensureSemicolon": true }
}
api_response.json
{
  "ok": true,
  "result": "SELECT id, name\nFROM users\nWHERE id = 1;",
  "stats": { "ms": 4, "inLen": 43, "outLen": 47 }
}
api_node.js
// Node.js (fetch)
const res = await fetch("https://zerlo.net/formattersql?api=1", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
sql: "SELECT * FROM orders WHERE created_at >= NOW() - INTERVAL '7 days';",
mode: "beautify",
options: { indent: 2, keywordCase: "upper", stripComments: true, ensureSemicolon: true }
  })
});
const data = await res.json();
console.log(data.result);
api_php.php
<?php
// PHP
$payload = [
  "sql" => "SELECT COUNT(*) FROM products;",
  "mode" => "minify",
  "options" => [ "indent" => 2, "keywordCase" => "preserve", "stripComments" => true, "ensureSemicolon" => true ]
];
$ch = curl_init("https://zerlo.net/formattersql?api=1");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode($payload),
  CURLOPT_RETURNTRANSFER => true
]);
$resp = curl_exec($ch);
curl_close($ch);
echo $resp;

8) Auto-test (étape par étape)

  1. Clique dans l'outil ci-dessous sur Auto-test – – trois cas clés sont vérifiés automatiquement..
  2. Cas de mise en forme : Mots-clés MAJUSCULE, sauts de ligne clairs, indentation propre.: Keywords UPPER, Cas de Beautify :
  3. Cas de Minification:: Commentaires supprimés (si l'option est activée), sortie compacte.
  4. Cas d'Indentation:: Changement visuel entre 2/4/8 espaces..
  5. Le résultat apparaît dans le panneau Auto-test ; en cas d'écarts : vérifier les options et, si nécessaire, changer de mode.

9) Conseils pro, performance et sécurité

10) Conseils de dialecte et limites

11) Dépannage & FAQ

„Rien ne change ?“ – Vérifie le mode et les options ; l'entrée ne doit pas être vide.

„Points-virgules en double ?“ – Option « forcer » + ; existant : désactiver l'option.

„Les commentaires n'ont pas été supprimés“ – Activez la suppression des commentaires ou réglez le mode sur « Minifier ».

„Très longues requêtes ralentissent le navigateur“ – Formater de gros blocs successivement ou utiliser l'API.

„Mots-clés dans les chaînes modifiés ?“ – Cela ne devrait pas arriver ; vérifie s'il s'agissait de vraies chaînes (guillemets), pas des backticks.

12) Maintenant, essayer

Démarre ici : zerlo.net/formattersql

Le guide t'a-t-il été utile ? N'hésite pas à le partager :