Best format guide

Best Format for Database Seed Replay

SQL is the best default when replay accuracy, transactions, and schema-aware setup matter more than raw interchange simplicity.

Recommendation

Recommendation

SQL

SQL preserves database-native operations like transactions, DDL, and ordered seed replay in a way flat exports cannot.

application/sql

CSV

Use CSV for tabular interchange where downstream loading rules are already defined.

Fichiers: 22

JSON

Use JSON when nested structures and payload debugging matter more than SQL replay semantics.

Fichiers: 22

Decision factors

Decision Factors

Facteurs de decision

  • Need for transactional replay versus flat data import.
  • Requirement to preserve schema changes, ordering, and rollback behavior.
  • Portability across toolchains versus database-native execution fidelity.
  • How often support or QA needs to inspect and diff the fixture by hand.

Erreurs courantes a eviter

  • Using CSV as the only seed artifact when ordered transactional replay is required.
  • Treating a large SQL fixture like a dummy blob instead of validating it against a real parser and database.
  • Skipping rollback rehearsal before promoting large seed loads into CI or staging.
FAQ

FAQ

Quelle est la recommandation principale dans ce guide ?

SQL est le choix recommande par defaut pour ce cas d'usage.

Comment les equipes doivent-elles valider ce choix de format ?

Utilisez des fixtures d'echantillon et les endpoints de manifeste pour tester compatibilite, performance et conversion dans des conditions proches de la production.