Django Settings

Django Settings

Di latihan sebelumnya, Anda sudah berhasil mendaftarkan Django app di INSTALLED_APPS yang ada di dalam settings.py. Settings.py adalah berkas yang berisi konfigurasi untuk proyek Django. Di dalam berkas tersebut sudah ada konfigurasi bawaan sehingga Anda tidak perlu mengubah atau menambahkannya jika tidak diperlukan. 

Mari kita lihat beberapa konfigurasi yang ada di dalamnya. Yang pertama adalah INSTALLED_APPS.

  1. INSTALLED_APPS = [
  2.     'django.contrib.admin',
  3.     'django.contrib.auth',
  4.     'django.contrib.contenttypes',
  5.     'django.contrib.sessions',
  6.     'django.contrib.messages',
  7.     'django.contrib.staticfiles',
  8. ]

Secara bawaan, INSTALLED_APPS memiliki app yang sudah terdaftar. Berikut penjelasan dari masing-masing app.

  • django.contrib.admin: Merupakan app Admin site.
  • django.contrib.auth: Merupakan sistem autentikasi.
  • django.contrib.contenttypes:  Framework untuk content types.
  • django.contrib.sessions: Framework untuk sessions..
  • django.contrib.messages: Framework untuk messages.
  • django.contrib.staticfiles:  Framework untuk berkas statis.

Setiap string yang ada di dalamnya harus mengarah ke konfigurasi aplikasi atau package dari pihak ketiga. Oleh karena itu, daftar string yang ada di dalamnya mungkin berubah sering waktu. 

Aplikasi yang ada di dalam list ini akan dimuat ketika server atau proyek Django dijalankan. Pada contoh di atas, “first_app” adalah Django app yang telah kita tambahkan sebelumnya pada “Latihan Membuat Proyek Pertamamu dengan Django”. Kita perlu untuk menuliskannya di dalam INSTALLED_APPS agar ia dimuat ketika menjalankan server.

Selain INSTALLED_APPS, di dalam settings.py juga terdapat konfigurasi lainnya seperti DATABASES.

  1. DATABASES = {
  2.     'default': {
  3.         'ENGINE': 'django.db.backends.sqlite3',
  4.         'NAME': BASE_DIR / 'db.sqlite3',
  5.     }
  6. }

DATABASES adalah sebuah Python dictionary yang berisi semua konfigurasi terkait database. Di dalam DATABASES setidaknya memiliki konfigurasi bawaan seperti contoh di atas. Ketika ingin menambahkan database lainnya, Anda dapat menuliskan konfigurasi di dalam DATABASES.

Ada banyak konfigurasi yang ada di dalam settings.py tetapi untuk memudahkan Anda belajar mengembangkan RESTful API dengan Django, kita hanya menggunakan konfigurasi yang esensial saja. Jika Anda ingin melihat apa saja konfigurasi yang tersedia, kunjungi laman daftar konfigurasi yang tersedia di Django.

Django Database dan Migrations

Ketika Anda menjalankan server development untuk proyek baru di Terminal akan tampak pesan seperti berikut.

dos-198bcb8b08c9f122732bd59de957c7e820241104161039.jpeg

Apa maksud dari pesan peringatan tersebut? Apakah Anda sudah tahu maksudnya? Jika tidak, ayo kita bahas!

Pesan error tersebut terjadi ketika sebuah proyek baru belum menerapkan migrations. Migrations adalah cara Django untuk menerapkan perubahan yang ada di model ke dalam database schema. Selain itu, migrations juga dapat berperan sebagai version control system untuk schema database yang ada di Django. Dengan kata lain, setiap perubahan yang terjadi di model akan tercatat di dalam migrations.

Model adalah sumber informasi tunggal tentang data yang ada di Django app. Di dalam model, Anda dapat mendefinisikan atribut yang diperlukan. Secara umum, satu model akan merujuk ke satu tabel di database.

Catatan:
Di kelas ini, kita tidak akan membahas database secara mendalam melainkan membahas yang pentingnya saja.

Database adalah kumpulan data yang terstruktur dan tersimpan dalam suatu sistem komputer. Database mampu menyimpan data dalam jumlah besar secara terstruktur sehingga proses pencarian ataupun pengolahan datanya akan menjadi lebih mudah. Selain itu, database juga merupakan penyimpanan persisten di mana data akan disimpan ke dalam hard disk atau di dalam memory sehingga data akan tetap aman meskipun aplikasinya mengalami update, restart, ataupun crash. 

Django secara resmi mendukung beberapa jenis database server, seperti PostgreSQL, MariaDB, MySQL, Oracle, dan SQLite. Namun, secara default Django menggunakan database SQLite sehingga menggunakannya sangat mudah tanpa perlu memasang database server. SQLite tidak membutuhkan database server dan konfigurasi tambahan.

Selain adanya pesan error tersebut di Terminal, saat Anda menjalankan perintah runserver secara otomatis Django membuat berkas db.sqlite3. Tanpa berakrobat, Anda dapat menggunakan database SQLite. Keren, kan?

dos-e4fe74518cbaf219933785e848e0af5620241104161039.jpeg

Secara default Django menggunakan database SQLite, jika ingin menggunakan database lainnya, butuh untuk menambahkan konfigurasi (akan kita bahas di modul berikutnya).

Agar tidak terjadi pesan error seperti itu lagi, Anda harus menjalankan migrations. Penasaran bagaimana caranya? Jangan lewatkan latihan berikutnya!

Berkenalan dengan ORM di Django

Sebelumnya, Anda sudah mengetahui pengertian database. Sebelum kita menggunakan database lebih jauh, kita akan berkenalan dulu dengan ORM.

ORM (Object-relational mapping) adalah teknik untuk menerjemahkan data dalam database dan yang digunakan di dalam konsep OOP (Object-oriented programming). ORM memudahkan developer ketika ingin berinteraksi dengan database. ORM dapat menyembunyikan kerumitan untuk berinteraksi dengan database seperti membuat, menerima, mengubah dan menghapus data. 

Untuk dapat menggunakan ORM, Anda harus memiliki model. Misalnya, model seperti berikut.

  1. class Product(models.Model):
  2.   name = models.CharField(max_length=255)
  3.   sku = models.CharField(max_length=255)
  4.   category = models.CharField(max_length=255)
  5.   price = models.DecimalField(max_digits=10, decimal_places=2)
  6.   stock = models.DecimalField(max_digits=10, decimal_places=2)
  7.   location = models.CharField(max_length=255)
  8.   is_available = models.BooleanField(default=False)

Model tersebut terdiri dari dua atribut, name dan tag. Untuk melakukan operasi, akan kita bahas beberapa operasi yang paling sering digunakan kedepannya. Yuk, kita simak!


Menambahkan Data

Untuk menambahkan data, Anda cukup menuliskan nama model dan diikuti oleh method save(). Perhatikan contoh berikut.

  1. from store.models import Product
  2. product = Product(name="Baju", sku="SK01", category="Fashion", price=100000, stock=122, location="Jakarta", is_available=True)
  3. product.save()

 Kode di atas sama seperti kita menuliskan SQL Statement berikut:

  1. INSERT INTO Products (nama atribut) VALUES (nilai dari atribut);


Menampilkan Data

Setelah data berhasil ditambahkan ke Database. Mungkin Anda butuh untuk menampilkannya. Untuk menampilkan data, Anda memiliki pilihan yang terdiri dari menampilkan satu data atau seluruh data. 

Untuk menampilkan satu data saja, Anda dapat memanggil method get() seperti berikut.

  1. from store.models import Product
  2. Product.objects.get(pk=1)

Method get() membutuhkan argumen berupa primary key. Primary key merupakan identitas dari objek yang ingin kita panggil yang bersifat unik. Pada contoh tersebut, produk dengan id 1 akan tampil.

Kode di atas akan menghasilkan sintaks SQL seperti berikut:

  1. SELECT "store_product"."id", "store_product"."name", "store_product"."sku", "store_product"."category", "store_product"."price", "store_product"."stock", "store_product"."location", "store_product"."is_available" FROM "store_product" WHERE "store_product"."id" = 1 LIMIT 21

Sementara itu, untuk mendapatkan seluruh data, Anda dapat menggunakan method all().

  1. from store.models import Product
  2. Product.objects.all()

Kode di atas akan menghasilkan sintaks SQL seperti berikut:

  1. SELECT "store_product"."id", "store_product"."name", "store_product"."sku", "store_product"."category",
  2. "store_product"."price", "store_product"."stock", "store_product"."location", "store_product"."is_available"
  3. FROM "store_product" LIMIT 21;

 

Mengubah Data

Selain menambahkan data, Anda juga dapat mengubah data yang sudah disimpan di Database. Terdapat dua pendekatan, mengubah data banyak sekaligus atau hanya satu data. 

Untuk mengubah hanya satu data, Anda dapat menggunakan pendekatan seperti berikut.

  1. from store.models import Product
  2. product = Product.objects.get(pk=1)  # mengambil produk
  3. product.stock = 120 # mengubah nilai stock
  4. product.save() # menyimpan perubahan ke database

Hal pertama yang dilakukan adalah mendapatkan data menggunakan get, kemudian mengubah nilainya dan terakhir menyimpan data menggunakan method save().

Di balik layar, kode tersebut akan menghasilkan SQL seperti berikut.

  1. SELECT "store_product"."id", "store_product"."name", "store_product"."sku", "store_product"."category", "store_product"."price", "store_product"."stock", "store_product"."location", "store_product"."is_available" FROM "store_product" WHERE "store_product"."id" = 1 LIMIT 21;
  2.  
  3. UPDATE "store_product" SET "name" = \'Baju\', "sku" = \'SK01\', "category" = \'Fashion\', "price" = 100000.00, "stock" = 120, "location" = \'Jakarta\', "is_available" = true WHERE "store_product"."id" = 1;

Di samping itu, untuk mengubah data dengan jumlah yang banyak sekaligus, Anda dapat memanfaatkan API dari QuerySet yaitu filter(). Perhatikan contoh berikut.

  1. from store.models import Product
  2. product = Product.objects.filter(location="Jakarta").update(stock=120)

Semua produk yang berlokasi di Jakarta akan terupdate stoknya menjadi 120.

Untuk bacaan lebih lanjut mengenai QuerySet, Anda dapat membacanya di Dokumentasi QuerySet.


Menghapus Data

Terakhir, menghapus data. Untuk menghapus data dari database, Anda dapat menggunakan method delete(). Method delete akan mengembalikan jumlah baris yang berhasil dihapus. Perhatikan contoh berikut.

  1. from store.models import Product
  2. product = Product.objects.get(pk=1)
  3. product.delete()

Operasi delete tersebut akan menghasilkan SQL berikut.

  1. SELECT "store_product"."id", "store_product"."name", "store_product"."sku", "store_product"."category", "store_product"."price", "store_product"."stock", "store_product"."location", "store_product"."is_available" FROM "store_product" WHERE "store_product"."id" = 1 LIMIT 21;
  2. DELETE FROM "store_product" WHERE "store_product"."id" IN (1);

 Atau, jika Anda ingin menghapus banyak data sekaligus dapat menggunakan cara seperti berikut. 

  1. from store.models import Product
  2. product = Product.objects.filter(category="Fashion").delete()

Pada contoh di atas, semua produk dengan kategori Fashion akan terhapus. Harap berhati-hati saat menggunakan cara ini karena data yang sudah terhapus tidak dapat dikembalikan.

Anda dapat mencoba menjalankan contoh kode di materi ini di django-admin shell.


Sudah siap untuk praktik langsung dengan database? Jika iya, ayo kita ayunkan tangan untuk memencet tombol next di sebelah kanan.

 

 

Latihan: Membuat dan Menjalankan Migrations

Anda sudah mengetahui pengertian dari migrations. Lalu, bagaimana cara untuk membuatnya? Sebelum itu, kita coba lihat terlebih dahulu perintah migrations apa saja yang ada di manage.py.

  • migrate: Perintah untuk menerapkan dan membatalkan migrations.
  • makemigrations: Perintah untuk membuat migrations baru berdasarkan perubahan yang terjadi di model.
  • sqlmigrate: Perintah untuk menampilkan statement SQL dari migrations.
  • showmigrations: Perintah untuk menampilkan daftar dan status migrations.

Anda mungkin sudah menebak, migrations diterapkan menggunakan perintah migrate. Yup, tebakan Anda benar. Ikuti langkah-langkah berikut ini untuk menerapkannya.

  1. Buka Terminal Anda.
  2. Sebelum kita menjalankan migrate, alangkah lebih baiknya kita melihat daftar migrations dan statusnya. Jalankan perintah berikut.
    1. python manage.py showmigrations
  1. Setelah itu, Anda akan melihat tampilan seperti berikut.
    dos-97dcf0cc07ef621c7657d3050fa0caa820241104171726.jpeg
    Di gambar tersebut, terlihat daftar migrations yang ada saat ini. Tanda X artinya adalah migrations sudah diterapkan. Di gambar tersebut juga terlihat bahwa migrations yang ada di Django app first_app belum diterapkan.
  1. Untuk menerapkan migrations tersebut, jalankan perintah berikut ini.
    1. python manage.py migrate
  1. Jika berhasil, Anda akan melihat hasil migrate-nya seperti berikut.dos-b8437c774b2b54e37d9efc631e5d267120241104171434.jpeg
    Loh, kok sudah berhasil menerapkan migrations-nya? Padahal, kan, kita belum membuat migrations dengan perintah makemigrations. Kenapa hal ini terjadi? Hal ini memungkinkan terjadi karena secara default Django sudah membuatkan migrations untuk table user, permissions dan sebagainya (Anda dapat melihatnya pada gambar di atas).
  2. Kemudian, jalankan kembali server development-nya dengan perintah python manage.py runserver.
  3. Anda tidak akan melihat lagi pesan peringatan yang sebelumnya muncul karena belum menerapkan migrations.dos-744721561c08e0911257139d7e35823f20241104171434.jpeg
  4. Selanjutnya, kita akan membuat migrations baru. Misalnya, ingin membuat tabel kucing dengan kolom name, color, dan type. Untuk membuat tabel, kita membutuhkan sebuah model. Misalnya, model Cat.  Untuk membuatnya, Anda harus mengubah berkas models.py. Buka berkas models.py yang ada di Django app “first_app”.
  5. Setelah itu, tambahkan kode berikut ini setelah baris kode import dependencies.
    1. from django.db import models
    2.  
    3. # Create your models here.
    4. class Cat(models.Model):
    5.     name = models.CharField(max_length=200)
    6.     color = models.CharField(max_length=50)
    7.     type = models.CharField(max_length=200)
    Kode di atas digunakan untuk membuat model Cat dengan atribut datanya yaitu name, color, dan type.
  1. Kemudian, jalankan perintah makemigrations berikut.
    1. python manage.py makemigrations
  1. Jika berhasil, Anda akan melihat satu berkas baru yang dihasilkan oleh perintah makemigrations. Berkas tersebut adalah berkas migrations. Berkas migrations tersebut tidak lazim diubah karena ia hasil generate dari model yang kita definisikan sebelumnya.
  2. Setelah itu, jalankan perintah migrate.
    1. python manage.py migrate
  1. Anda akan melihat tampilan seperti berikut.dos-e7ad36e2f68fab1b753e71361e8af32120241104171434.jpegMigrations yang kita buat telah berhasil diterapkan.
  2. Untuk memastikan hal tersebut, kita dapat mengujinya dengan melakukan eksplorasi database di shell. Jalankan perintah “python manage.py shell” untuk masuk ke dalam shell.
  3. Kemudian, import model Cat dengan menuliskan kode berikut.
    1. from first_app.models import Cat
  1. Selanjutnya, dapatkan seluruh data yang ada di database menggunakan Django ORM. Tulis kode berikut.
    1. Cat.objects.all()
    Kode di atas akan mengembalikan semua objek dari tabel cat.
  1. Jika berhasil, Anda akan melihat tampilan seperti berikut.
    dos-8066a0e3282fce5d8a89a1a656b15fa920241104172600.jpeg
    Hasil dari Cat.objects.all() adalah queryset. Queryset adalah kumpulan objek di Database. Pada contoh di atas, queryset bernilai kosong karena kita belum menambahkan datanya.
  1. Saat ini, kita sudah berhasil membuat model dan menjalankan migrations. Selain itu, kita juga sudah berhasil mencoba untuk berinteraksi dengan database dan mendapatkan data dari database.

Selamat! Anda sudah berhasil membuat migrations dan menjalankannya. Kini, Anda sudah memiliki bekal untuk membuat aplikasi Back-End yang membutuhkan database. Jangan berpuas dulu karena kita masih ada materi selanjutnya yang lebih menarik!

Catatan:
Untuk melihat migrations dan database schema selain menggunakan shell, Anda dapat melakukannya dengan memanfaatkan plugin yang ada di PyCharm.

Selain itu, kita juga dapat memastikan hal tersebut dengan melihat database schema melalui database viewer yang dapat dipasang sebagai plugin di PyCharm.

  1. Saat ini, terdapat banyak database viewer yang gratis, tetapi di kelas ini kita akan menggunakan “Database Navigator". Anda dapat mencari plugin “Database Navigator” dan memasangnya dengan cara mengunjungi halaman tutorial memasang plugin. Database Navigator dapat dipasang di PyCharm versi 242 ke bawah. Setelah berhasil memasangnya, Anda akan melihat Database Navigator pada tab Installed yang ada di Settings Plugins.
    dos-fdc0b07be73852753b2679897935119320241104173241.jpeg
  1. Di sebelah kiri, Anda akan melihat menu yang bernama DB Browser. Klik menu tersebut.
    dos-267a4c5fca4bf89257ce524086a8f90620241104173255.jpeg 
  1. Setelah itu, klik icon tambah.dos-15d985f779938ae5c52ed82123d3bbda20241104171434.jpeg
  2. Selanjutnya, kita akan menambahkan koneksi ke database. Pilih SQLite.
    dos-f0c445008baae6ce9a0548396ba7f58720241104173402.jpeg
  3. Akan tampak pop up seperti berikut.
    dos-f90bf3ba8381dd6a9d43a4ffd90877ae20241104173537.jpeg
  4. Anda dapat menuliskan nama koneksi tersebut seperti berikut.
    dos-ab45ce26b520385fd5b185c741c73e5e20241104173547.jpeg
  5. Kemudian, pilih berkas database yang dihasilkan oleh migrate sebelumnya dengan cara klik titik tiga yang ada di bagian Connection.dos-99b6889728a1054b1ea610f1c802efee20241104171434.jpeg
  6. Akan muncul pop up untuk memilih path dari berkas SQLite seperti berikut.
    dos-2d908ec9eac7af690b77698e2d91416920241104173710.jpeg
  7. Selanjutnya, klik OK.
  8. Setelah itu, klik Test Connection.dos-770acf380ba11b04d0f326c7c5501b3120241104171434.jpeg
  9. Pastikan koneksi tersebut berhasil.dos-3f1c0d505ae828e06becad1ee9e6f24520241104171434.jpeg
  10. Kemudian, klik Apply dan OK.
  11. Anda akan melihat koneksi yang ditambahkan sudah berhasil tampil di DB Browser.
    dos-b043cb72b955a88a1df71f77fd7f94e320241104173833.jpeg
  12. Klik Schemas -> Main -> Tables sehingga tampil tabel seperti berikut.
    dos-fe6e7f01b91e2221d1f81a16fc6f44d320241104173849.jpeg

Anda dapat melihat bahwa kita sudah berhasil membuat tabel baru melalui migrations. Selain itu, kita juga sudah memiliki tabel user yang dibuat oleh Django secara bawaan. Keren, kan?


Bersambung ke:

RESTful API dengan Django dan REST Framework



Comments

Post a Comment

Popular posts from this blog

BackEnd Python Developer

  BackEnd Developer Backend developer adalah pengembang yang fokus pada "balik layar" aplikasi atau website, mencakup server, database, dan logika aplikasi . Mereka bertugas membangun infrastruktur, API, dan mengelola data agar sistem berjalan efisien dan aman. Skill utama meliputi bahasa pemrograman (Python, Java, PHP, Go), database (SQL/NoSQL), dan kerangka kerja (framework) seperti Laravel atau Django. [1, 2, 3, 4, 5, 6] Tugas Utama Backend Developer: Mengembangkan Server-Side Logic: Menulis kode yang menjalankan layanan web. Manajemen Database: Merancang, mengelola, dan mengoptimalkan basis data untuk menyimpan data aplikasi. Pembuatan API (Application Programming Interface): Membuat RESTful API agar frontend dapat berkomunikasi dengan backend. Keamanan dan Performa: Memastikan keamanan data dan mengoptimalkan kecepatan respons aplikasi. [1, 3, 4, 5, 6, 7] Skill yang Dibutuhkan: Bahasa Pemrograman: Python, Java, PHP, JavaScript (Node.js), Ruby, atau Go. Database: My...
Read more

Prasyarat Kemampuan

  Prasyarat Kemampuan Sebelum mengikuti keseluruhan materi, idealnya Anda sudah memiliki bekal kemampuan dalam bahasa pemrograman Python. Simak penjelasan di bawah ini mengenai masing-masing kemampuan yang perlu Anda miliki.  Mengerti dan mampu menuliskan kode program menggunakan Python.  Mengerti dan mampu menangani  error  yang mungkin muncul di Python. Mengerti dan mampu menyiapkan lingkungan pengembangan di Python. Mengerti dan mampu mengimplementasikan object-oriented programming di Python. Seluruh prasyarat kemampuan di atas dapat Anda capai dengan mengikuti kelas Memulai Pemrograman dengan Python. Nah, sekarang Anda sudah mengetahui kan apa saja bekal yang harus dimiliki sebelum mempelajari keseluruhan materi? Apakah bekal kemampuan Anda sudah cukup? Jika belum, kami sangat menyarankan Anda untuk berkenalan dengan semua materi di atas terlebih dahulu sebelum melanjutkan ke materi selanjutnya. 23% Selesai Pendahuluan Pengenalan Back-End Dasar-Dasar Web Ser...
Read more