Menyediakan data awal untuk model

Terkadang berguna untuk pra-pengumpulan basisdata anda dengan data kode-keras ketika anda sedang pertama kali menyetel sebuah aplikasi. Anda dapat menyediakan data inisial dengan perpindahan atau perlengkapan.

Menyediakan data inisial dengan perpindahan

Jika anda ingin otomatis memuat data inisial untuk sebuah aplikasi, buat sebuah :ref:`data migration `. Perpindahan berjalan ketika mengatur basisdata, jadi data akan tersedia disana, Subyek pada :ref:`some limitations `.

Menyediakan data dengan perlengkapan

Anda dapat juga menyediakan data menggunakan fixture, data ini tidak dimuat secara otomatis, kecuali jika anda menggunakan TransactionTestCase.fixtures.

Perlengkapan tetap adalah sebuah kumpulan dari data yang Django ketahui bagaimana diimpor kedalam sebuah basisdata. Kebanyakan jalan mudah dari pembuatan perlengkapan tetap jika anda telah mendapatkan beberapa data adalah untuk menggunakan perintah manage.py dumpdata. Atau, anda dapat menulis perlengkapan tetap dengan tangan; perlengkapan tetap dapat ditulis sebagai dokumen JSON, XML atau YAML (dengan PyYAML terpasang). serialization documentation mempunyai lebih rincian tentang setiap dari ini serialization formats yang didukung.

Sebagai sebuah contoh, meskipun, ini adalah apa sebuah perlengkapan tetap untuk mode Person sederhana mungkin kelihatan seperti di JSON:

[
  {
    "model": "myapp.person",
    "pk": 1,
    "fields": {
      "first_name": "John",
      "last_name": "Lennon"
    }
  },
  {
    "model": "myapp.person",
    "pk": 2,
    "fields": {
      "first_name": "Paul",
      "last_name": "McCartney"
    }
  }
]

Dan ini adalah yang perlengkapan tetap sama seperti YAML:

- model: myapp.person
  pk: 1
  fields:
    first_name: John
    last_name: Lennon
- model: myapp.person
  pk: 2
  fields:
    first_name: Paul
    last_name: McCartney

Anda akan menyimpan data ini dalam sebuah direktori fixtures didalam aplikasi anda.

Memuat data sangat mudah: cukup panggil manage.py loaddata <fixturename>, dimana <fixturename> adalah nama dari berkas perlengkapan tetap anda telah buat. Setiap kali anda menjalankan loaddata, data akan dibaca dari perlengkapan tetap dan dimuat kembali kedalam basisdata. Catat ini berarti bahwa jika anda merubah satu dari baris-baris dibuat oleh sebuah perlengkapan tetap dan kemudian menjalankan loaddata kembali, anda akan menyapu bersih setiap perubahan anda telah buat.

Dimana Django menemukan berkas-berkas perlengkapan tetap

Secara awal, Django mencari dalam direktori fixtures didalam setiap aplokasi untuk perlengkapan tetap. Anda dapat mengatur pengaturan :setting:`FIXTURE_DIRS`ke sebuah daftar dari direktoti tambahan dimana Django seharusnya melihat.

Ketika menjalankan manage.py loaddata, anda dapat juga menentukan sebuah jalur untuk berkas alat bantu, yang menimpa pencarian direktori-direktori biasanya.

lihat juga

Perlengkapan tetap juga digunakan oleh testing framework untuk membantu mengatur kelesarasan lingkungan percobaan.