A SQL linter and formatter, 50× faster than sqruff.
- SQLClean flags SQL that runs but rarely does what you meant, applies safe fixes, and formats every file
- one way. Custom Rules are plain Python functions, backed by a Rust API that keeps them fast.
+ SQLClean spots SQL patterns that look right but quietly misbehave, such as = NULL or a
+ NOT IN list with a NULL, applies safe fixes, and formats every file one way.
+ Custom Rules are plain Python functions, backed by a Rust API that keeps them fast.
WHERE x = NULL runs without an error and matches no rows.
Reviewers argue about commas and casing instead of the logic.
"Use COALESCE, not IFNULL" holds until someone new misses it.
+"Use COALESCE, not IFNULL" is only a convention until a tool checks it.
Default Rules flag comparisons with NULL, NOT IN lists that contain
NULL, and ROW_NUMBER with no deterministic order. Each finding points at the
@@ -243,8 +244,8 @@
Keep them fixed
A custom Rule is a Python function over statement facts, already parsed and located for you. This team uses COALESCE instead of IFNULL to keep queries portable. The Rule reads function calls, @@ -372,7 +373,7 @@
Real output from sqlclean on small example projects, trimmed to the relevant lines.
Each panel shows actual sqlclean output on a small example project, cut down to the findings that matter.
The docs cover every command, every Rule, configuration and custom Rules.
+Browse every Rule with examples, then set up configuration, custom Rules and CI.