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.

Bestanden: 22

JSON

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

Bestanden: 22

Decision factors

Decision Factors

Beslisfactoren

  • 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.

Veelvoorkomende fouten om te vermijden

  • 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

Wat is de primaire aanbeveling in deze gids?

SQL is hier het aanbevolen standaardformaat.

Hoe moeten teams deze formaatkeuze valideren?

Gebruik voorbeeldfixtures en manifest-eindpunten om compatibiliteit, prestaties en conversiegedrag in productie-achtige omstandigheden te testen.