---
title: "フィクスチャー"
version: 4.2
locale: ja
source: https://docs.djangoproject.com/ja/4.2/topics/db/fixtures/
canonical: https://djangodocs.dev/ja/4.2/topics/db/fixtures/
---
# フィクスチャー

> **See also**
>
> - [モデルに対する初期データを投入する](/ja/4.2/howto/initial-data/)

## フィクスチャーとは何ですか？

*フィクスチャー (fixture)* とは、データベースのシリアル化されたコンテンツを含むファイルのコレクションです。各フィクスチャーにはユニークな名前があり、フィクスチャを構成するファイルは、複数のアプリケーションの複数のディレクトリに分散できます。

## フィクスチャーはどのように作成するべきですか？

Fixtures can be generated by [`manage.py dumpdata`](/ja/4.2/ref/django-admin/#django-admin-dumpdata). It's
also possible to generate custom fixtures by directly using [serialization
tools](/ja/4.2/topics/serialization/) or even by handwriting them.

## How to use a fixture?

Fixtures can be used to pre-populate database with data for
[tests](/ja/4.2/topics/testing/tools/#topics-testing-fixtures):

```python
class MyTestCase(TestCase):
    fixtures = ["fixture-label"]
```

or to provide some [initial data](/ja/4.2/howto/initial-data/#initial-data-via-fixtures) using the
[`loaddata`](/ja/4.2/ref/django-admin/#django-admin-loaddata) command:

```shell
django-admin loaddata <fixture label>
```

## Django はどこでフィクスチャーを探しますか？

Django will search in these locations for fixtures:

1. インストールされた各アプリケーションの `fixtures` ディレクトリ内
2. In any directory listed in the [`FIXTURE_DIRS`](/ja/4.2/ref/settings/#std-setting-FIXTURE_DIRS) setting
3. フィクスチャによって名前が付けられたリテラル パス内

Django will load any and all fixtures it finds in these locations that match
the provided fixture names. If the named fixture has a file extension, only
fixtures of that type will be loaded. For example:

```shell
django-admin loaddata mydata.json
```

`mydata` と呼ばれる JSON フィクスチャーのみを読み込みます。フィクスチャーの拡張子は [シリアライザ](/ja/4.2/topics/serialization/#serialization-formats) に登録された名前 (例: `json` や `xml`)  に対応していなければなりません。

If you omit the extensions, Django will search all available fixture types for
a matching fixture. For example:

```shell
django-admin loaddata mydata
```

would look for any fixture of any fixture type called `mydata`. If a fixture
directory contained `mydata.json`, that fixture would be loaded as a JSON
fixture.

The fixtures that are named can include directory components. These directories
will be included in the search path. For example:

```shell
django-admin loaddata foo/bar/mydata.json
```

would search `<app_label>/fixtures/foo/bar/mydata.json` for each installed
application, `<dirname>/foo/bar/mydata.json` for each directory in
[`FIXTURE_DIRS`](/ja/4.2/ref/settings/#std-setting-FIXTURE_DIRS), and the literal path `foo/bar/mydata.json`.

### Fixtures loading order

Multiple fixtures can be specified in the same invocation. For example:

```shell
django-admin loaddata mammals birds insects
```

or in a test case class:

```python
class AnimalTestCase(TestCase):
    fixtures = ["mammals", "birds", "insects"]
```

The order in which fixtures are loaded follows the order in which they are
listed, whether it's when using the management command or when listing them in
the test case class as shown above.

In these examples, all the fixtures named `mammals` from all applications (in
the order in which applications are defined in [`INSTALLED_APPS`](/ja/4.2/ref/settings/#std-setting-INSTALLED_APPS)) will
be loaded first. Subsequently, all the `birds` fixtures will be loaded,
followed by all the `insects` fixtures.

Be aware that if the database backend supports row-level constraints, these
constraints will be checked at the end of the transaction. Any relationships
across fixtures may result in a load error if the database configuration does
not support deferred constraint checking (refer to the [MySQL](https://dev.mysql.com/doc/refman/en/constraint-foreign-key.html) docs for an
example).

## フィクスチャーはどのようにデータベースに保存されますか？

When fixture files are processed, the data is saved to the database as is.
Model defined [`save()`](/ja/4.2/ref/models/instances/#django.db.models.Model.save) methods are not called, and
any [`pre_save`](/ja/4.2/ref/signals/#django.db.models.signals.pre_save) or
[`post_save`](/ja/4.2/ref/signals/#django.db.models.signals.post_save) signals will be called with
`raw=True` since the instance only contains attributes that are local to the
model. You may, for example, want to disable handlers that access
related fields that aren't present during fixture loading and would otherwise
raise an exception:

```
from django.db.models.signals import post_save
from .models import MyModel

def my_handler(**kwargs):
    # disable the handler during fixture loading
    if kwargs["raw"]:
        return
    ...

post_save.connect(my_handler, sender=MyModel)
```

You could also write a decorator to encapsulate this logic:

```
from functools import wraps

def disable_for_loaddata(signal_handler):
    """
    Decorator that turns off signal handlers when loading fixture data.
    """

    @wraps(signal_handler)
    def wrapper(*args, **kwargs):
        if kwargs["raw"]:
            return
        signal_handler(*args, **kwargs)

    return wrapper

@disable_for_loaddata
def my_handler(**kwargs):
    ...
```

Just be aware that this logic will disable the signals whenever fixtures are
deserialized, not just during [`loaddata`](/ja/4.2/ref/django-admin/#django-admin-loaddata).

## 圧縮されたフィクスチャー

フィクスチャーは `zip`、`gz`、`bz2`、`lzma`、`xz` フォーマットのいずれかに圧縮される場合があります。次に例を示します。

```shell
django-admin loaddata mydata.json
```

would look for any of `mydata.json`, `mydata.json.zip`, `mydata.json.gz`,
`mydata.json.bz2`, `mydata.json.lzma`, or `mydata.json.xz`. The first
file contained within a compressed archive is used.

Note that if two fixtures with the same name but different fixture type are
discovered (for example, if `mydata.json` and `mydata.xml.gz` were found in
the same fixture directory), fixture installation will be aborted, and any data
installed in the call to [`loaddata`](/ja/4.2/ref/django-admin/#django-admin-loaddata) will be removed from the database.

> **MyISAM を使用した MySQL とフィクスチャー**
>
> The MyISAM storage engine of MySQL doesn't support transactions or
> constraints, so if you use MyISAM, you won't get validation of fixture
> data, or a rollback if multiple transaction files are found.

## データベース別のフィクスチャー

If you're in a multi-database setup, you might have fixture data that
you want to load onto one database, but not onto another. In this
situation, you can add a database identifier into the names of your fixtures.

For example, if your [`DATABASES`](/ja/4.2/ref/settings/#std-setting-DATABASES) setting has a `users` database
defined, name the fixture `mydata.users.json` or
`mydata.users.json.gz` and the fixture will only be loaded when you
specify you want to load data into the `users` database.