---
title: "Fornecendo dados iniciais para modelos."
version: 3.0
locale: pt-br
source: https://docs.djangoproject.com/pt-br/3.0/howto/initial-data/
canonical: https://djangodocs.dev/pt-br/3.0/howto/initial-data/
---
# Fornecendo dados iniciais para modelos.

Algumas vezes é útil pre-popular o seu banco de dados com dados hard-coded quando você está configurando a sua aplicação pela primeira vez. Você pode prover dados iniciais como migrations ou fixtures.

## Provendo dados iniciais com migrations

Se você quer carregar automaticamente dados iniciais para a sua aplicação, crie uma data migration \` (ou migração de dados). Migrações são executadas enquanto o banco de dados de teste é configurado, então os dados serão disponíveis lá, sujeito a :ref:\`algumas limitações.

## Provendo dados com fixtures.

Você também pode prover dados usando fixtures, no entanto, esses dados não são carregados automaticamente, exceto se você usar [`TransactionTestCase.fixtures`](/pt-br/3.0/topics/testing/tools/#django.test.TransactionTestCase.fixtures).

Uma fixture é uma coleção de dados que o Django sabe como importar para o banco de dados. A maneira mais fácil de criar uma “fixture” se você já tem  algum dado é usar o comando [`manage.py dumpdata`](/pt-br/3.0/ref/django-admin/#django-admin-dumpdata). Ou, você pode escrever fixtures manualmente; “fixtures” podem ser escritas como documentos JSON, XML ou YAML (com [PyYAML](https://pyyaml.org/) installed). O [documentos de serialização](/pt-br/3.0/topics/serialization/) tem mais detalhes sobre cada um destes [formatos de serialização](/pt-br/3.0/topics/serialization/#serialization-formats).

As an example, though, here’s what a fixture for a `Person` model might look
like in JSON:

```js
[
  {
    "model": "myapp.person",
    "pk": 1,
    "fields": {
      "first_name": "John",
      "last_name": "Lennon"
    }
  },
  {
    "model": "myapp.person",
    "pk": 2,
    "fields": {
      "first_name": "Paul",
      "last_name": "McCartney"
    }
  }
]
```

E aqui a mesma “fixture” como YAML:

```yaml
- model: myapp.person
  pk: 1
  fields:
    first_name: John
    last_name: Lennon
- model: myapp.person
  pk: 2
  fields:
    first_name: Paul
    last_name: McCartney
```

Você armazenará este dado em um diretório `fixtures` dentro de sua app.

You can load data by calling [`manage.py loaddata`](/pt-br/3.0/ref/django-admin/#django-admin-loaddata)
`<fixturename>`, where `<fixturename>` is the name of the fixture file
you’ve created. Each time you run [`loaddata`](/pt-br/3.0/ref/django-admin/#django-admin-loaddata), the data will be read
from the fixture and re-loaded into the database. Note this means that if you
change one of the rows created by a fixture and then run [`loaddata`](/pt-br/3.0/ref/django-admin/#django-admin-loaddata)
again, you’ll wipe out any changes you’ve made.

### Onde o Django encontra arquivos de “fixture”

Por padrão, o Django procura por “fixtures” no diretório `fixtures` dentro de cada app. Você definir a [`FIXTURE_DIRS`](/pt-br/3.0/ref/settings/#std-setting-FIXTURE_DIRS) como uma lista de diretórios adicionais onde o Django deve procurar.

Quando chamar [`manage.py loaddata`](/pt-br/3.0/ref/django-admin/#django-admin-loaddata), você pode especificar um caminho para o arquivo de “fixture”, o qual é procurado no lugar dos diretórios usuais.

> **See also**
>
> As “Fixtures” são também usadas pelo [testing framework](/pt-br/3.0/topics/testing/tools/#topics-testing-fixtures) para auxiliar na configuração de um ambiente de teste consistente.