Skip to main content
Use selfcheck when evaluating supaschema against an existing database or after upgrading the engine. The command extracts a live catalog, re-renders the modeled SQL, re-extracts it, and reports identity normalization gaps.

Use this when

  • You are validating catalog normalization.
  • A provider-specific object shape may need investigation.
  • An upgrade should be checked against a real database.
  • You need diagnostics for engine parity work.

Run it

selfcheck is a diagnostic tool, not a deployment gate. Review mismatches before deciding whether they matter.

Flags

url
PostgreSQL URL to extract. Defaults to normal database URL resolution.

Exit codes

Inspect

Print the extracted model directly.

Fingerprint

Compare normalized model hashes.

Corpus

Run dirty-real regression coverage.

Support matrix

Check modeled object coverage.
Last modified on June 16, 2026