Khi cần chuyển dữ liệu giữa máy dev và máy chủ, hoặc sao lưu trước một migration nguy hiểm, đừng copy file database hay tự viết script chèn. Django có sẵn hai lệnh quản lý làm đúng việc này: dumpdata xuất toàn bộ hoặc một phần dữ liệu ra file JSON, còn loaddata nạp lại file đó vào database khác. Chỉ cần hai lệnh, dữ liệu đi nguyên vẹn từ máy này sang máy khác.
Vấn đề
Tình huống quen thuộc: blog có 200 bài viết trên máy dev, cần đưa lên máy staging để test giao diện mới. Hoặc bạn sắp chạy migration đổi kiểu cột và muốn có bản sao lưu để quay lại nếu sai. Cách quen tay nhất là copy file db.sqlite3.
# Chỉ đúng với SQLite, không chuyển được sang PostgreSQL hay MySQLcp db.sqlite3 db.sqlite3.bak
Cách này có ba điểm yếu: chỉ đúng với SQLite, không chọn lọc được một app hay một model, và vô dụng khi hai máy dùng database khác loại nhau. Viết script Python tự đọc rồi chèn lại cũng không khá hơn: dài dòng, dễ quên khóa ngoại, dễ lệch khóa chính.
Giải pháp
dumpdata xuất dữ liệu ra JSON (mặc định), mỗi bản ghi gồm tên model, khóa chính và các field. Xuất một model duy nhất:
python manage.py dumpdata blog.Post --indent 2 > posts.json
Muốn sao lưu toàn bộ database thì bỏ tên model, nhưng nên loại trừ hai nhóm dữ liệu hệ thống — quyền (auth.permission) và kiểu nội dung (contenttypes) — vì chúng được tạo lại khi migrate:
python manage.py dumpdata --exclude auth.permission --exclude contenttypes --indent 2 > backup.json
Để khôi phục, chạy migrate trước để bảng tồn tại, rồi nạp file:
python manage.py migratepython manage.py loaddata posts.json
loaddata tìm file trong thư mục fixtures của mỗi app, trong FIXTURE_DIRS nếu bạn cấu hình, hoặc nhận đường dẫn tuyệt đối. Khi hai database khác loại (ví dụ SQLite sang PostgreSQL), thêm cờ --natural-foreign và --natural-primary khi dump để khóa ngoại ghi bằng khóa tự nhiên. Lưu ý: model tự viết cần định nghĩa natural_key() thì cờ này mới có tác dụng.
Áp dụng vào dự án của bạn
Đưa hai lệnh này vào thói quen làm việc: trước mỗi migration nguy hiểm, chạy dumpdata để có bản sao lưu đặt cạnh code; khi dev mới clone dự án, gửi kèm file fixture dữ liệu mẫu thay vì bảo họ tự nhập tay; trong CI, nạp fixture bằng loaddata để test luôn chạy trên cùng bộ dữ liệu. Dữ liệu thành một file văn bản trong repo — xem diff được, khôi phục chỉ mất một lệnh.
Bài viết liên quan
- Django: tạo lệnh quản lý tùy chỉnh — seed dữ liệu và chạy tác vụ nền trong 5 phút
- Django: dùng raw SQL an toàn khi ORM không đủ — objects.raw() và cursor() trong 5 phút
- Django: viết test cho view bằng TestCase và Client — bắt lỗi trước khi deploy trong 5 phút
Câu hỏi thường gặp
Sao lưu bằng cách copy file db.sqlite3 có được không?
Được, nhưng chỉ khi cả hai máy dùng SQLite và bạn cần toàn bộ database. Với PostgreSQL hay MySQL thì không có file để copy, cũng không chọn lọc được một app hay một model. dumpdata làm được cả hai việc đó.
Vì sao loaddata báo lỗi trùng khóa chính?
Vì database đích đã có bản ghi cùng khóa chính — thường do nạp fixture hai lần, hoặc database chưa làm trống. Cách xử lý: nạp vào database trống sau migrate, hoặc dùng flush để xóa dữ liệu cũ trước. Nhớ chạy migrate trước, vì bảng chưa tồn tại thì loaddata lỗi ngay.
loaddata có gọi save() và signal của model không?
Không. loaddata ghi thẳng vào database, bỏ qua phương thức save() bạn tự định nghĩa; signal pre_save/post_save vẫn chạy nhưng nhận cờ raw=True. Nếu logic quan trọng nằm trong save() hay signal, kiểm tra lại dữ liệu sau khi nạp.
Chuyển dữ liệu từ SQLite sang PostgreSQL có dùng được dumpdata không?
Được, nếu dump bằng cờ --natural-foreign --natural-primary để khóa ngoại không còn là số id. Model tự viết cần định nghĩa natural_key() thì cờ này mới có tác dụng. Với dữ liệu lớn, file JSON có thể nặng — hãy dùng pg_dump.
💬 Bạn đã thử cách này trong dự án của mình chưa? Nếu gặp lỗi hoặc có cách làm gọn hơn, để lại bình luận bên dưới — mình đọc hết và sẽ bổ sung những ý hay vào bài.
Nguồn tham khảo
- Django Documentation — dumpdata and loaddata: https://docs.djangoproject.com/en/6.1/ref/django-admin/#dumpdata
- Django Documentation — Serializing Django objects: https://docs.djangoproject.com/en/6.1/topics/serialization/
- Django Documentation — Providing initial data with fixtures: https://docs.djangoproject.com/en/6.1/howto/initial-data/
