Seed

Definição

Seed é a rotina ou o conjunto de registros usado para popular inicialmente um ambiente. Ele prepara a base para desenvolvimento, teste ou demonstração, garantindo que o sistema encontre conteúdo de partida assim que a estrutura existe.

Registros necessários e registros fictícios

Dois tipos de registros entram em um seed. Alguns são necessários ao funcionamento, como configurações iniciais e cadastros obrigatórios. Outros são fictícios e servem para demonstração, como clientes e pedidos de exemplo que facilitam testar telas e fluxos.

INSERT INTO clientes (id, nome, email) VALUES
(1, 'Ana', 'ana@example.com'),
(2, 'Bruno', 'bruno@example.com'),
(3, 'Carla', 'carla@example.com');

Seed e migration trabalham em etapas diferentes

Seed não substitui migration. Migration registra mudanças de estrutura, como criar tabelas e acrescentar campos. Seed prepara registros dentro da estrutura já existente. Em um fluxo de ambiente, primeiro a estrutura evolui, depois o conteúdo de partida é carregado.

Falha comum e como verificar

A falha mais comum é um seed que não é reproduzível, porque roda duas vezes e duplica os registros de partida. Sem uma rotina que limpe ou ignore o que já existe, o segundo acesso encontra clientes repetidos e os fluxos de teste quebram. Para verificar, execute a rotina duas vezes seguidas em um ambiente limpo e confira se a quantidade final de registros permanece a mesma. Depois, altere um registro fictício e rode o seed de novo. Quando o conteúdo volta ao ponto de partida, a rotina cumpre o papel de preparar o ambiente.

Aplicação na formação

Developer Workspace

Na Formação Developer Workspace, o seed prepara o ambiente local com registros fictícios para testar telas e fluxos.

Conhecer a formação →