{"title":"Menulis aplikasi Django kedua anda, bagian 2","version":"6.1","locale":"id","docname":"intro/tutorial02","url":"/id/6.1/intro/tutorial02/","canonical":"https://djangodocs.dev/id/6.1/intro/tutorial02/","summary":"Ttutorial ini memulai dimana Tutorial 1 ditinggalkan. Kami akan menyetelbasisdata, buat model pertama anda, dan dapatkan pengenalan cepat pada…","html":"

Menulis aplikasi Django kedua anda, bagian 2Link to this heading#

\n

Ttutorial ini memulai dimana Tutorial 1 ditinggalkan. Kami akan menyetelbasisdata, buat model pertama anda, dan dapatkan pengenalan cepat pada dibangkitkan-otomatis situs admin Django.

\n\n
\n

Pengaturan basisdataLink to this heading#

\n

Sekarang, buka mysite/settings.py. Dia adalah modul Phyton biasa dengan variabel tingkat-modul mewakili pengaturan Django.

\n

By default, the DATABASES configuration uses SQLite. If you're new\nto databases, or you're just interested in trying Django, this is the easiest\nchoice. SQLite is included in Python, so you won't need to install anything\nelse to support your database. When starting your first real project, however,\nyou may want to use a more scalable database like PostgreSQL, to avoid\ndatabase-switching headaches down the road.

\n

If you wish to use another database, see details to customize and get\nyour database running.

\n

Ketika anda menyunting mysite/settings.py, setel TIME_ZONE ke zona waktu anda.

\n

Juga, catat pengaturan INSTALLED_APPS pada bagian atas berkas. Yang menahan nama dari semua aplikasi Django yang diaktifkan di instance Django. Aplikasi dapat digunakan d banyak proyek, dan anda dapat memaketkan dan menyebarkan mereka untuk digunakan oleh lainnya di proyek mereka.

\n

Secara awal, INSTALLED_APPS mengandung aplikasi berikut, semua yang datang dengan Django:

\n\n

Aplikasi ini disertakan secara awal sebagai kenyamanan untuk kasus umum.

\n

Beberapa aplikasi ini memanfaatkan setidaknya satu tabel basisdata, meskipun, jadi kami butuh untuk membuat tabel di basisdata sebelum kami dapat menggunakannya. Untuk melakukannya, jalankan perintah berikut:

\n

Linux / macOS

Shell
$ python manage.py migrate\n
\n

Windows

Windows
...\\> py manage.py migrate\n
\n

Perintah migrate mencari INSTALLED_APPS setelan dan membuat tabel database yang diperlukan menurut pengaturan basisdata anda dalam berkas mysite/settings.py dan perpindahan basisdata disertai dengan aplikasi (kami akan membahas itu nanti). Anda akan melihat sebuah pesan untuk setiap perpindahan yang sudah dilakukan, jalankan baris-perintah klien untuk basisdata anda dan ketik \\dt (PostgreSQL), SHOW TABLES; (MariaDB, MySQL), .tables (SQLite), atau SELECT TABLE_NAME FROM USER_TABLES; (Oracle) untuk menampilkan tabel-tabel Django yang dibuat.

\n\n
\n
\n

Membuat modelLink to this heading#

\n

Sekarang kami akan menentukan model anda -- Pada dasarnya, tata letak basisdata anda, dengan metadata tambahan.

\n\n

Dalam aplikasi jejak pendapat kami, kami akan membuat dua model: Question dan Choice. Question memiliki pertanyaan dan tanggal penerbitan. Choice memiliki dua bidang: teks dari pilihan dan perhitungan pilihan. Setiap Choice dikaitkan dengan Question.

\n

Konsep ini diwakilkan oleh kelas Python. Sunting berkas polls/models.py sehingga terlihat seperti ini:

\n
polls/models.py
\n
Python
from django.db import models\n\n\nclass Question(models.Model):\n    question_text = models.CharField(max_length=200)\n    pub_date = models.DateTimeField("date published")\n\n\nclass Choice(models.Model):\n    question = models.ForeignKey(Question, on_delete=models.CASCADE)\n    choice_text = models.CharField(max_length=200)\n    votes = models.IntegerField(default=0)\n
\n

Disini, setiap model diwakilkan dengan kelas yang subkelas django.db.models.Model. Masing-masing model mempunyai sejumlah variabel kelas, setiapnya mewakilkan sebuah bidang basisdata dalam model.

\n

Setiap bidang diwakilkan oleh contoh dari kelas Field class -- sebagai contoh CharField untuk bidang karakter dan DateTimeField untuk tanggal waktu. Ini memberitahu Django jenis apa dari data setiap bidang yang disimpan.

\n

Nama dari setiap instance Field (sebagai contoh question_text` or pub_date) adalah nama bidang, di bentuk mesin-bersahabat. Anda akan menggunakan nilai ini di kode Phyton, dan basisdata anda akan menggunakannya sebagai nama kolom.

\n

Anda dapat menggunakan pilihan argumen penempatan pertama pada Field untuk merancang nama dapat dibaca-manusia. Itu digunakan di pasangan bagian mawas diri dari Django dan dia mengganda sebagai dokumentasi. Jika bidang ini tidak disediakan, Django akan menggunakan nama dapat dibaca-manusia. Di contoh ini, kami telah hanya menentukan nama dapat dibaca-manusia untuk Question.pub_date. Untuk semua bidang lain di model ini, nama dapat dibaca-mesin akan mencukupi sebagai nama dapat dibaca-manusia nya.

\n

Beberapa kelas Field mempunyai argumen wajib. CharField, sebagai contoh, membutuhkan anda memberikannya sebuah max_length. Yang digunakan tidak hanya untuk di skema basisdata, tetapi di pengesahan, seperti yang segera kita lihat.

\n

Sebuah Field dapa juga mempunyai beragam argumen pilihan; dalam kasus ini, kami telah menyetel nilai default dari pilih ke 0.

\n

Akhirnya, catatan hubungan ditentukan, menggunakan ForeignKey. Yang mengatakan Django setiap Choice terhubung pada Question tunggal. Django mendukung semua hubungan basisdata umum: banyak-ke-satu, banyak-ke-banyak, dan satu-ke-satu.

\n
\n
\n

Mengaktifkan modelLink to this heading#

\n

Ada banyak informasi yang dapat disampaikan oleh beberapa baris contoh kode di atas. Dengan kode ini, Django dapat melakukan:

\n\n

Tetapi pertama kami butuh untuk memberitahu proyek kam bahwa aplikasi jejak pendapat telah terpasang.

\n\n

Untuk menyertakan aplikasi di proyek kami, kami butuh menambahkan acuan pada kelas konfigurasinya di pengaturan INSTALLED_APPS. Kelas PollsConfig ada di berkas polls/apps.py, jadi jalur bertitiknya adalah 'polls.apps.PollsConfig'. Sunting berkas mysite/settings.py dan tambah jalur bertitik itu ke pengaturan INSTALLED_APPS. itu akan terlihat seperti ini:

\n
mysite/settings.py
\n
Python
INSTALLED_APPS = [\n    "polls.apps.PollsConfig",\n    "django.contrib.admin",\n    "django.contrib.auth",\n    "django.contrib.contenttypes",\n    "django.contrib.sessions",\n    "django.contrib.messages",\n    "django.contrib.staticfiles",\n]\n
\n

Sekarang Django tahu menyertakan aplikasi polls. Mari kita jalankan perintah lain:

\n

Linux / macOS

Shell
$ python manage.py makemigrations polls\n
\n

Windows

Windows
...\\> py manage.py makemigrations polls\n
\n

Anda harus melihat sesuatu yang mirip pada berikut:

\n
Text
Migrations for 'polls':\n  polls/migrations/0001_initial.py\n    + Create model Question\n    + Create model Choice\n
\n

Dengan menjalankan makemigrations, anda mengatakan ke Django bahwa anda telah membuat beberapa perubahan di model anda (dalam kasus ini, anda telah membuat satu baru) dan itu anda ingin perubahan disimpan sebagai migration.

\n

Perpindahan adalah bagaimana Django menyimpan perubahan ke model anda (dan dengan demikian skema basisdata anda) - mereka adalah berkas-berkas di cakram. Anda dapat membaca perpindahan untuk model baru anda jika anda suka; itu adalah berkas polls/migrations/0001_initial.py. Jangan khawatir, anda tidak diharapkan membaca mereka setiap waktu Django membuatnya, tetapi mereka dirancang untuk menjadi dapat-disunting-manusia dalam kasus anda ingin secara manual mengutik bagaimana Django merubah hal-hal.

\n

Jika anda tertarik, anda dapat juga menjalankan python periksa manage.py; pemeriksaan ini untuk masalah apapun di proyek anda tanpa membuat perindahan tempat atau menyentuk basisdata.

\n

Sekarang, jalankan migrate kembali untuk membuat tabel model tersebut di basisdata anda:

\n

Linux / macOS

Shell
$ python manage.py migrate\nOperations to perform:\n  Apply all migrations: admin, auth, contenttypes, polls, sessions\nRunning migrations:\n  Applying polls.0001_initial... OK\n
\n

Windows

Windows
...\\> py manage.py migrate\nOperations to perform:\n  Apply all migrations: admin, auth, contenttypes, polls, sessions\nRunning migrations:\n  Applying polls.0001_initial... OK\n
\n

Perintah migrate membawa semua pemindahan tempat yang belum diberlakukan (Django melacak yang mana diberlakukan menggunakan tabel khusus di basisdata anda disebut django_migrations) dan menjalankan mereka terhadap basisdata anda - pada dasarnya, sinkronisasi perubahan anda buat ke model anda dengan skema di basisdata.

\n

Pemindahan tempat adalah sangat kuat dan membuat anda merubah model anda lembur, ketika anda mengembangkan proyek anda, tanpa buth menghapus basisdata anda atau tabel dan membuat satu yang baru - Dia khusus dalam meningkatkan basisdata langsung, tanpa kehilangan data. Kami akan melingkupi mereka lebih dalam di bagian kemudian dari tutorial, tetapi untuk sekarang, ingat panduan tiga-langkah untuk membuat perubahan model:

\n\n

Alasan bahwa ada perintah terpisah untuk membuat dan memberlakukan perpindahan karena anda akan menyerahkan perpindahan ke sistem kendali versi anda dan mengirimkan mereka dengan aplikasi anda; mereka tidak hanya membuat pengembangan anda lebih mudah, mereka juga berguna oleh pengembang-pengembang lain dan dalam produksi.

\n

See Perpindahan for the full details, including how to inspect\nthe SQL a migration will run with sqlmigrate (see\nExecuting sqlmigrate).

\n

Baca django-admin documentation untuk informasi penuh pada apa kegunaan manage.py dapat lakukan.

\n
\n
\n

Bermain dengan APILink to this heading#

\n

Sekarang, mari kita melompat ke dalam shell Phyton dan bermain dengan API bebas Django yang diberikan ke anda. Untuk memintah shell Phyton, gunakan perintah ini:

\n

Linux / macOS

Shell
$ python manage.py shell\n
\n

Windows

Windows
...\\> py manage.py shell\n
\n

We're using this instead of simply typing "python", because manage.py\nsets the DJANGO_SETTINGS_MODULE environment variable, which gives\nDjango the Python import path to your mysite/settings.py file.\nBy default, the shell command automatically imports the models from\nyour INSTALLED_APPS.

\n

Once you're in the shell, explore the database API:

\n
Python console
# No questions are in the system yet.\n>>> Question.objects.all()\n<QuerySet []>\n\n# Create a new Question.\n# Support for time zones is enabled in the default settings file, so\n# Django expects a datetime with tzinfo for pub_date. Use timezone.now()\n# instead of datetime.datetime.now() and it will do the right thing.\n>>> from django.utils import timezone\n>>> q = Question(question_text="What's new?", pub_date=timezone.now())\n\n# Save the object into the database. You have to call save() explicitly.\n>>> q.save()\n\n# Now it has an ID.\n>>> q.id\n1\n\n# Access model field values via Python attributes.\n>>> q.question_text\n"What's new?"\n>>> q.pub_date\ndatetime.datetime(2012, 2, 26, 13, 0, 0, 775217, tzinfo=datetime.UTC)\n\n# Change values by changing the attributes, then calling save().\n>>> q.question_text = "What's up?"\n>>> q.save()\n\n# objects.all() displays all the questions in the database.\n>>> Question.objects.all()\n<QuerySet [<Question: Question object (1)>]>\n
\n

Tunggu dulu. <Question: Question object (1)> bukanlah perwakilan membantu dari obyek ini. Mari kita perbaiki itu dengan menyunting modl Question (dalam berkas polls/models.py) dan menambahkan sebuah metode __str__() pada kedua Question dan Choice:

\n
polls/models.py
\n
Python
from django.db import models\n\n\nclass Question(models.Model):\n    # ...\n    def __str__(self):\n        return self.question_text\n\n\nclass Choice(models.Model):\n    # ...\n    def __str__(self):\n        return self.choice_text\n
\n

Sangat penting menambahkan cara __str__() ke model anda, tidak hanya kenyamanan anda ketika berurusan dengan prompt interaktif, tetapi juga karena perwakilan obyek digunakan di seluruh admin dibangkitkan-otomatis Django.

\n

Mari kita tambahkan sebuah metode penyesuaian pada model ini:

\n
polls/models.py
\n
Python
import datetime\n\nfrom django.db import models\nfrom django.utils import timezone\n\n\nclass Question(models.Model):\n    # ...\n    def was_published_recently(self):\n        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)\n
\n

Catat tambahand dari import datetime dan from django.utils import timezone, untuk mengacu standar Phyton modul datetime dan kegunaan zona-waktu-terhubung Django di django.utils.timezone, masing-masing. Jika anda belum akrab dengan penanganan zona waktu di Phyton, anda dapat mempelajari lebih di dokumen dukungan zona waktu.

\n

Save these changes and start a new Python interactive shell. (If a\nthree-chevron prompt (>>>) indicates you are still in the shell, you need to\nexit first using exit()). Run python manage.py shell again to reload\nthe models.

\n
Python console
# Make sure our __str__() addition worked.\n>>> Question.objects.all()\n<QuerySet [<Question: What's up?>]>\n\n# Django provides a rich database lookup API that's entirely driven by\n# keyword arguments.\n>>> Question.objects.filter(id=1)\n<QuerySet [<Question: What's up?>]>\n>>> Question.objects.filter(question_text__startswith="What")\n<QuerySet [<Question: What's up?>]>\n\n# Get the question that was published this year.\n>>> from django.utils import timezone\n>>> current_year = timezone.now().year\n>>> Question.objects.get(pub_date__year=current_year)\n<Question: What's up?>\n\n# Request an ID that doesn't exist, this will raise an exception.\n>>> Question.objects.get(id=2)\nTraceback (most recent call last):\n    ...\nDoesNotExist: Question matching query does not exist.\n\n# Lookup by a primary key is the most common case, so Django provides a\n# shortcut for primary-key exact lookups.\n# The following is identical to Question.objects.get(id=1).\n>>> Question.objects.get(pk=1)\n<Question: What's up?>\n\n# Make sure our custom method worked.\n>>> q = Question.objects.get(pk=1)\n>>> q.was_published_recently()\nTrue\n\n# Give the Question a couple of Choices. The create call constructs a new\n# Choice object, does the INSERT statement, adds the choice to the set\n# of available choices and returns the new Choice object. Django creates\n# a set (defined as "choice_set") to hold the "other side" of a ForeignKey\n# relation (e.g. a question's choice) which can be accessed via the API.\n>>> q = Question.objects.get(pk=1)\n\n# Display any choices from the related object set -- none so far.\n>>> q.choice_set.all()\n<QuerySet []>\n\n# Create three choices.\n>>> q.choice_set.create(choice_text="Not much", votes=0)\n<Choice: Not much>\n>>> q.choice_set.create(choice_text="The sky", votes=0)\n<Choice: The sky>\n>>> c = q.choice_set.create(choice_text="Just hacking again", votes=0)\n\n# Choice objects have API access to their related Question objects.\n>>> c.question\n<Question: What's up?>\n\n# And vice versa: Question objects get access to Choice objects.\n>>> q.choice_set.all()\n<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>\n>>> q.choice_set.count()\n3\n\n# The API automatically follows relationships as far as you need.\n# Use double underscores to separate relationships.\n# This works as many levels deep as you want; there's no limit.\n# Find all Choices for any question whose pub_date is in this year\n# (reusing the 'current_year' variable we created above).\n>>> Choice.objects.filter(question__pub_date__year=current_year)\n<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>\n\n# Let's delete one of the choices. Use delete() for that.\n>>> c = q.choice_set.filter(choice_text__startswith="Just hacking")\n>>> c.delete()\n
\n

Untuk informasi lebih di kaitan model, lihat Accessing related objects. Untuk lebih bagaimana menggunakan garis bawah ganda untuk melakukan bidang lookup melalui API, lihat Field lookups. Untuk rincian penuh di basisdata API, lihat Database API reference kami.

\n
\n
\n

Memperkenalkan Admin DjangoLink to this heading#

\n\n
\n

Membuat pengguna adminLink to this heading#

\n

Pertama kami akan butuh membuat pengguna yang dapat masuk ke situs admin. Jalankan perintah berikut:

\n

Linux / macOS

Shell
$ python manage.py createsuperuser\n
\n

Windows

Windows
...\\> py manage.py createsuperuser\n
\n

Masukkan nama pengguna anda inginkan dan tekan enter.

\n
Text
Username: admin\n
\n

Anda akan diarahkan ke alamat surel yang anda inginkan:

\n
Text
Email address: admin@example.com\n
\n

Langkah akhir adalah memasukkan sandi anda. Anda akan diminta memasukkan sandi anda dua kali, kedua kali sebagai penegasan dari yang pertama.

\n
Text
Password: **********\nPassword (again): *********\nSuperuser created successfully.\n
\n
\n
\n

Nyalakan peladen pengembanganLink to this heading#

\n

Situs Admin Django diaktifkan secara awal. Mari kita nyalakan peladen pengembangan dan jelajahi dia.

\n

Jika peladen tidak berjalan nyalakan seperti biasa:

\n

Linux / macOS

Shell
$ python manage.py runserver\n
\n

Windows

Windows
...\\> py manage.py runserver\n
\n

Sekarang, buka peramban jaringan dan pergi ke "/admin/" di domain lokal anda -- yaitu, http://127.0.0.1:8000/admin/. Anda seharusnya melihan layar masuk admin:

\n\"Layar\n

Sejak translation dinyalakan secara awalan, jika anda mensetel LANGUAGE_CODE, layar masuk akan ditampilkan dalam bahasa yang diberikan (jika Django memiliki terjemahan yang sesuai).

\n
\n
\n

Masuk situs adminLink to this heading#

\n

Sekarang, coba masuk dengan akun superuser anda telah buat di langkah sebelumnya. Anda seharusnya melihat halaman index admin Django:

\n\"Halaman\n

Anda seharusnya melihat beberapa jenis isi dapat disunting: kelompok dan pengguna. Mereka disediakan oleh django.contrib.auth, kerangka pembuktian keaslian dikirim oleh Django.

\n
\n
\n

Buat aplikasi jejak pendapat dapat di rubah di adminLink to this heading#

\n

Tetapi dimana aplikasi jejak pendapat kami? DIa tidak ditampilkan di halaman index admin.

\n

Hanya satu hal lagi untuk dilakukan: kami butuh memberitahu admin bahwa obyek Question memiliki antarmuka admin. Untuk melakukan ini, buka berkas polls/admin.py, dan sunting itu untuk terlihat seperti ini:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\nadmin.site.register(Question)\n
\n
\n
\n

Jelajahi fungsi admin bebasLink to this heading#

\n

Sekarang kita telah mendaftarkan Question, Django mengetahui bahwa itu harus ditampilkan di halaman index admin:

\n\"Halaman\n

Klik Question. Sekarang anda berada di halaman "change list" untuk pertanyaan. Halaman ini menampilkan semua pertanyaan di basisdata dan membiarkan anda memilih satu untuk merubahnya. Ada pertanyaan "Ada apa? kami buat sebelumnya:

\n\"Halaman\n

Klik pertanyaan "Ada apa?" untuk menyuntingnya:

\n\"Menyunting\n

Hal-hal untuk dicatat disini:

\n\n

Bagian bawah halaman memberikan anda pasangan pilihan:

\n\n

Jika nilai "Tanggal diterbitkan" tidak cocok waktu ketika anda membuat pertanyaan di Tutorial 1, itu kemungkinan berarti anda lupa untuk mengatur nilai benar untuk pengaturan TIME_ZONE. Rubah itu, muat kembali halaman dan periksa bahwa nilai benar muncul.

\n

Rubah "Tanggal diterbitkan" dengan mengklik jalan pintas "Hari ini" dan "Sekarang". Lalu klik "Simpan dan lanjut menyunting". Lalu klik "Sejarah" di kanan atas. Anda akan melihat halaman menampilkan semua perubahan yang dibuat pada obyek ini melalui admin Django, dengan stempel waktu dan nama pengguna dari orang yang membuat perubahan:

\n\"Halaman\n

Ketika anda sudah nyaman dengan API model dan telah mengakrabkan diri anda dengan situs admin, baca part 3 of this tutorial untuk mempelajari tentang bagaimana menambahkan tampilan lebih ke aplikasi jejak pendapat kami.

\n
\n
","rootId":"writing-your-first-django-app-part-2","toc":[{"title":"Pengaturan basisdata","anchor":"database-setup","children":[]},{"title":"Membuat model","anchor":"creating-models","children":[]},{"title":"Mengaktifkan model","anchor":"activating-models","children":[]},{"title":"Bermain dengan API","anchor":"playing-with-the-api","children":[]},{"title":"Memperkenalkan Admin Django","anchor":"introducing-the-django-admin","children":[{"title":"Membuat pengguna admin","anchor":"creating-an-admin-user","children":[]},{"title":"Nyalakan peladen pengembangan","anchor":"start-the-development-server","children":[]},{"title":"Masuk situs admin","anchor":"enter-the-admin-site","children":[]},{"title":"Buat aplikasi jejak pendapat dapat di rubah di admin","anchor":"make-the-poll-app-modifiable-in-the-admin","children":[]},{"title":"Jelajahi fungsi admin bebas","anchor":"explore-the-free-admin-functionality","children":[]}]}],"breadcrumbs":[{"docname":"intro/index","title":"Mulai","url":"/id/6.1/intro/"}],"prev":{"docname":"intro/tutorial01","title":"Menulis aplikasi Django pertama anda, bagian 1","url":"/id/6.1/intro/tutorial01/"},"next":{"docname":"intro/tutorial03","title":"Menulis aplikasi Django pertama anda, bagian 3","url":"/id/6.1/intro/tutorial03/"},"formats":{"html":"/id/6.1/intro/tutorial02/","markdown":"/id/6.1/intro/tutorial02.md","json":"/id/6.1/intro/tutorial02.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/intro/tutorial02.txt","official":"https://docs.djangoproject.com/id/6.1/intro/tutorial02/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}