Il est parfois utile de pré-remplir la base de données avec des données fixes au moment de la première configuration d’une application. Vous pouvez fournir des données initiales avec des instantanés ou des migrations.
\nUn instantané (fixture en anglais) est un ensemble de données que Django peut importer dans une base de données. La façon la plus directe de créer un instantané si vous avez déjà les données dans votre base est d’utiliser la commande manage.py dumpdata. Sinon, vous pouvez aussi créer des instantanés manuellement ; ils peuvent être écrits sous forme de documents JSON, XML ou YAML. La documentation sur la sérialisation contient plus de détails sur chacun de ces formats de sérialisation.
Comme exemple, voici à quoi pourrait ressembler un instantané pour un simple modèle Person en JSON :
[\n {\n "model": "myapp.person",\n "pk": 1,\n "fields": {\n "first_name": "John",\n "last_name": "Lennon"\n }\n },\n {\n "model": "myapp.person",\n "pk": 2,\n "fields": {\n "first_name": "Paul",\n "last_name": "McCartney"\n }\n }\n]\nEt voici le même instantané en YAML :
\n- model: myapp.person\n pk: 1\n fields:\n first_name: John\n last_name: Lennon\n- model: myapp.person\n pk: 2\n fields:\n first_name: Paul\n last_name: McCartney\nCes données doivent se trouver dans un répertoire fixtures à l’intérieur de votre application.
Le chargement des données est simple : il suffit d’appeler manage.py loaddata <nom_instantané>, où <nom_instantané> est le nom du fichier instantané que vous avez créé. Lors de chaque lancement de loaddata, les données de l’instantané sont lues et rechargées dans la base de données. Notez que cela signifie que si vous modifiez l’un des objets créés par l’instantané et que vous relancez loaddata, vous écraserez toute modification effectuée en base de données.
Par défaut, Django recherche des instantanés dans un répertoire fixtures pour chaque application. Vous pouvez définir le réglage FIXTURE_DIRS à une liste de répertoires supplémentaires dans lesquels Django doit chercher.
Quand vous lancez manage.py loaddata, vous pouvez aussi indiquer un chemin vers un fichier d’instantané, ce qui remplace la recherche dans les répertoires habituels.
Si vous souhaitez charger automatiquement des données initiales pour une application, n’utilisez pas des instantanés. Utilisez plutôt une migration de l’application contenant des opérations RunPython ou RunSQL.