アプリを最初にセットアップするとき、データベースに、ハードコーディングされたデータをあらかじめ入力しておくと便利なことがあります。マイグレーションまたはフィクスチャで初期データを提供できます。
\nアプリの初期データを自動的にロードするには、 データマイグレーション を作成します。マイグレーションはテストデータベースのセットアップ時に実行されるため、 いくつかの条件 を満たすことで、データが利用できるようになります。
\nフィクスチャ (fixture) を使ってデータを投入することもできますが、 TransactionTestCase.fixtures を使わない限り、このデータは自動的にはロードされません。
フィクスチャは、Djangoがデータベースにインポートする方法を知っているデータのコレクションです。 すでにいくつかのデータがある場合、フィクスチャを作成する最も簡単な方法は manage.py dumpdata コマンドを使用することです。 もしくは、フィクスチャを手動で書くこともできます; フィクスチャは JSON、XML、または (PyYAML をインストールして) YAML ドキュメントとして記述できます。 シリアライズのドキュメント でサポートされている各 シリアライズフォーマット の詳細を確認できます。
例として、 Person モデルのフィクスチャを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]\nYAML のフィクスチャだと以下のようになります:
\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\nこのデータは、アプリケーション内の fixtures ディレクトリ内に保存しておくことができます。
データを読み込むには、 manage.py loaddata <fixturename> を呼び出します。ここで <fixturename> は作成したフィクスチャファイルの名前です。 loaddata を実行するたびに、フィクスチャからデータが読み込まれ、データベースに再ロードされます。これは、フィクスチャによって作成された行の一つを変更してから loaddata を再度実行すると、変更が元に戻ってしまうことを意味します。
デフォルトでは、Djangoは各アプリ内の fixtures ディレクトリでフィクスチャを探すため、loaddata sample コマンドで my_app/fixtures/sample.json ファイルを見つけられます。相対パスも使用できるため、loaddata my_app/sample とすると my_app/fixtures/my_app/sample.json ファイルを見つけられます。
Django は FIXTURE_DIRS 設定で指定されたディレクトリのリストからもフィクスチャを探します。
デフォルトの検索を完全に無効にするには、フィクスチャファイルの場所を絶対パスで指定します。例えば、loaddata /path/to/sample のようにします。