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.

Archivos: 22

JSON

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

Archivos: 22

Decision factors

Decision Factors

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

Errores comunes a evitar

  • 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

Cual es la recomendacion principal de esta guia?

SQL es la recomendacion por defecto para este caso de uso.

Como deberian validar los equipos esta eleccion de formato?

Usa fixtures de muestra y endpoints de manifiesto para probar compatibilidad, rendimiento y conversion en condiciones similares a produccion.