När du först konfigurerar en app kan det ibland vara användbart att förfylla databasen med hårdkodade data. Du kan tillhandahålla initialdata med migreringar eller fixtures.
\nFör att automatiskt ladda initiala data för en app, skapa en datamigrering. Migreringar körs när testdatabasen konfigureras, så data kommer att finnas tillgängliga där, med förbehåll för vissa begränsningar.
\nDu kan också ange data med fixtures, men dessa data laddas inte automatiskt, förutom om du använder TransactionTestCase.fixtures.
En fixtur är en samling data som Django vet hur man importerar till en databas. Det enklaste sättet att skapa en fixtur om du redan har en del data är att använda kommandot manage.py dumpdata. Eller så kan du skriva fixturer för hand; fixturer kan skrivas som JSON-, XML- eller YAML-dokument (med PyYAML installerat). I serialization documentation finns mer information om vart och ett av dessa stödda serialization formats.
Men här är ett exempel på hur en fixtur för en Person-modell kan se ut i 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]\nOch här är samma fixtur som 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\nDu lagrar dessa data i katalogen fixtures i din app.
Du kan ladda data genom att anropa manage.py loaddata <fixturename>, där <fixturename> är namnet på den fixturfil du har skapat. Varje gång du kör loaddata kommer data att läsas från fixturen och laddas om till databasen. Observera att detta innebär att om du ändrar en av raderna som skapats av en fixtur och sedan kör loaddata igen, kommer du att radera alla ändringar du har gjort.
Som standard letar Django efter fixturer i katalogen fixtures i varje app, så kommandot loaddata sample kommer att hitta filen my_app/fixtures/sample.json. Detta fungerar även med relativa sökvägar, så loaddata my_app/sample kommer att hitta filen my_app/fixtures/my_app/sample.json.
Django letar också efter fixturer i listan över kataloger som anges i inställningen FIXTURE_DIRS.
För att helt förhindra att standardsökning sker, använd en absolut sökväg för att ange platsen för din fixture-fil, t.ex. loaddata /path/to/sample.