フィクスチャ (fixture) とは、シリアライズされたデータベースのコンテンツを含むファイルのコレクションです。各フィクスチャにはユニークな名前があり、フィクスチャを構成するファイルは、複数のアプリケーションの複数のディレクトリに分散できます。
\n\nフィクスチャは manage.py dumpdata によって生成できます。また、 シリアライゼーションツール を直接使って、あるいは手書きでカスタムフィクスチャを生成することもできます。
フィクスチャを使えば、 テスト のためのデータを事前に投入できます。
\nclass MyTestCase(TestCase):\n fixtures = ["fixture-label"]\nまたは 初期データ を loaddata コマンドを使って提供することもできます:
django-admin loaddata <fixture label>\nDjango はこれらの場所でフィクスチャを探します:
\nインストールされた各アプリケーションの fixtures ディレクトリ内
FIXTURE_DIRS 設定にリストされている任意のディレクトリ内
フィクスチャによって名前が付けられたリテラル パス内
Django は、指定されたフィクスチャ名と一致するフィクスチャをすべて読み込みます。指定されたフィクスチャに拡張子がある場合、そのタイプのフィクスチャだけが読み込まれます。たとえば
\ndjango-admin loaddata mydata.json\nmydata と呼ばれる JSON フィクスチャのみを読み込みます。フィクスチャの拡張子は シリアライザ に登録された名前 (例: json や xml) に対応していなければなりません。
拡張子を省略した場合、Django は利用可能なすべてのフィクスチャタイプから、マッチするフィクスチャを検索します。例えば
\ndjango-admin loaddata mydata\nこれは mydata というフィクスチャタイプのフィクスチャを探します。フィクスチャディレクトリに mydata.json が含まれていれば、そのフィクスチャは JSON フィクスチャとして読み込まれます。
命名されたフィクスチャはディレクトリ・コンポーネントを含むことができます。これらのディレクトリは検索パスに含まれます。たとえば:
\ndjango-admin loaddata foo/bar/mydata.json\nこれは、インストールされている各アプリケーションに対して <app_label>/fixtures/foo/bar/mydata.json を、 FIXTURE_DIRS 内の各ディレクトリに対して <dirname>/foo/bar/mydata.json を、そしてリテラルパス foo/bar/mydata.json を検索します。
複数のフィクスチャを同じ呼び出しで指定できます。たとえば:
\ndjango-admin loaddata mammals birds insects\nまたはテストケースクラスで:
\nclass AnimalTestCase(TestCase):\n fixtures = ["mammals", "birds", "insects"]\nフィクスチャが読み込まれる順番は、管理コマンドを使うときでも、上で示したようにテストケースクラスでリストアップするときでも、リストアップされた順番に従います。
\nこれらの例では、すべてのアプリケーション（ INSTALLED_APPS で定義されたアプリケーションの順番）から mammals という名前のすべてのフィクスチャが最初に読み込まれます。続いて、すべての birds フィクスチャが読み込まれ、続いてすべての insects フィクスチャが読み込まれます。
データベースのバックエンドが行レベルの制約をサポートしている場合、これらの制約はトランザクションの最後にチェックされることに注意してください。データベース構成が遅延制約チェックをサポートしていない場合、フィクスチャをまたぐリレーションシップは読み込みエラーになるかもしれません（例については MySQL のドキュメントを参照してください）。
\nフィクスチャファイルが処理されると、データはそのままデータベースに保存されます。モデルで定義された save() メソッドは呼び出されず、 pre_save や post_save シグナルは raw=True で呼び出されます。インスタンスはモデルにローカルな属性しか持たないからです。例えば、フィクスチャの読み込み中に存在せず、例外を発生させるようなリレーション先フィールドにアクセスするハンドラを無効にしたい場合があるでしょう:
from django.db.models.signals import post_save\nfrom .models import MyModel\n\n\ndef my_handler(**kwargs):\n # disable the handler during fixture loading\n if kwargs["raw"]:\n return\n ...\n\n\npost_save.connect(my_handler, sender=MyModel)\nこのロジックをカプセル化するデコレータを書くこともできます:
\nfrom functools import wraps\n\n\ndef disable_for_loaddata(signal_handler):\n """\n Decorator that turns off signal handlers when loading fixture data.\n """\n\n @wraps(signal_handler)\n def wrapper(*args, **kwargs):\n if kwargs["raw"]:\n return\n signal_handler(*args, **kwargs)\n\n return wrapper\n\n\n@disable_for_loaddata\ndef my_handler(**kwargs): ...\nこのロジックは、 loaddata の間だけでなく、フィクスチャがデシリアライズされるときは常にシグナルを無効にすることに注意してください。
フィクスチャは zip、gz、bz2、lzma、xz フォーマットのいずれかに圧縮される場合があります。次に例を示します。
django-admin loaddata mydata.json\nこれは mydata.json, mydata.json.zip, mydata.json.gz, mydata.json.bz2, mydata.json.lzma, mydata.json.xz のいずれかを探します。圧縮アーカイブに含まれる最初のファイルが使用されます。
同じ名前で異なるフィクスチャタイプを持つ2つのフィクスチャが見つかった場合(例えば、 mydata.json と mydata.xml.gz が同じフィクスチャディレクトリで見つかった場合)、フィクスチャのインストールは中断され、 loaddata の呼び出しでインストールされたデータはデータベースから削除されることに注意してください。
複数のデータベースをセットアップしている場合、あるデータベースには読み込ませたいが、別のデータベースには読み込ませたくないフィクスチャ・データがあるかもしれません。このような状況では、フィクスチャの名前にデータベース識別子を追加できます。
\n例えば、 DATABASES 設定に users データベースが定義されている場合、フィクスチャの名前を mydata.users.json または mydata.users.json.gz とすると、 users データベースにデータを読み込むと指定したときだけフィクスチャが読み込まれます。