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.

Arquivos: 22

JSON

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

Arquivos: 22

Decision factors

Decision Factors

Fatores de decisao

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

Erros comuns 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

Qual e a recomendacao principal deste guia?

SQL e o padrao recomendado para este caso de uso.

Como as equipes devem validar esta escolha de formato?

Use fixtures de amostra e endpoints de manifesto para testar compatibilidade, performance e conversao em condicoes proximas da producao.