Hubungan tetap¶

Hubungan tetap menghindari kelebihan dari pembangunan-kembali sebuah hubungan pada basisdata dalam setiap permintaan. mereka dikendalikan dengan parameter CONN_MAX_AGE yang menentukan umur waktu maksimal dari setiap hubungan. Itu dapat disetel secara berdiri sendiri untuk setiap basisdata.

The default value is 0, preserving the historical behavior of closing the database connection at the end of each request. To enable persistent connections, set CONN_MAX_AGE to a positive integer of seconds. For unlimited persistent connections, set it to None.

Penyandian¶

Django menganggap bahwa semua basisdata menggunakan penyandian UTF-8. Menggunakan penyandian lain mungkn menghasilkan perilaku tidak diharapkan seperti kesalahan "nilai terlalu panjang" dari basisdata anda untuk data yang sah dalam Django. Lihat basisdata catatan khusus dibawah untuk informasi pada bagaimana menyetel basisdata anda dengan benar.

Pengaturan hubungan PostgreSQL¶

Lihat HOST untuk rincian.

Mengoptimalkan konfigurasi PostgreSQL¶

Django butuh parameter berikut untuk hubungan basisdatanya:

• client_encoding: 'UTF8',
• default_transaction_isolation: 'read committed' secara awalan, atau nilai disetel dalam pilihan hubungan (lihat dibawah),
• timezone: 'UTC' ketika USE_TZ adalah True, nilai TIME_ZONE sebaliknya.

Jika parameter ini sudah memiliki nilai benar, Django tidak akan mensetel mereka untuk setiap hubugan baru, yang which memperbaiki sedikit penampilan. Anda dapat menkonfigurasi mereka langsung dalam postgresql.conf atau lebih nyaman per pengguna basisdata ALTER ROLE.

Django akan bekerja baik tanpa optimalisasi ini, tetapi setiap hubungan baru akan melakukan beberapa permintaan untuk mensetel parameter ini.

Tingkat terpencil¶

Seperti PostgreSQL itu sendiri, awalan Django pada READ COMMITTED isolation level. Jika anda butuh tingkat terpencil tertinggi seperti REPEATABLE READ atau SERIALIZABLE, setel itu dalam bagian OPTIONS dari konfigurasi basisdata anda dalam DATABASES:

import psycopg2.extensions

DATABASES = {
    # ...
    'OPTIONS': {
        'isolation_level': psycopg2.extensions.ISOLATION_LEVEL_SERIALIZABLE,
    },
}

Indeks untuk kolom varchar dan text¶

Ketika menentukan db_index=True pada bidang model anda, Django khususnya mengeluarkan pernyataan tunggal CREATE INDEX. Bagaimanapun, jika jenis basisdata untuk bidang adalah baik salah satu varchar atau text (misalnya, digunakan oleh CharField, FileField, dan TextField), kemudian Django akan membuat sebuah indeks tambahan yang menggunakan PostgreSQL operator class untuk kolom. Indeks tambahan diperlukan untuk dengan benar melakukan pencarian yang menggunakan penghubung LIKE dalam SQL mereka, ketika selesai dengan jenis pencarian contains dan startswith.

Tindakan perpindahan untuk menambahkan tambahan.¶

Jika anda butuh menambahkan sebuah tambahan PostgreSQL (seperti hstore, postgis, dll.) menggunakan perpindahan, gunakan tindakan CreateExtension.

Kursor sisi-peladen¶

Ketika menggunakan QuerySet.iterator(), Django membuka sebuah server-side cursor. Secara awalan, PostgreSQL menganggap bahwa hanya 10% pertama dari hasil dari kursor permintaan akan diambil. Perencana penerimaan menghabiskan sedikit waktu merencanakan permintaan dan memulai mengembalikan hasil lebih cepat, tetapi ini dapat mengurangi penampilan jika lebih dari 10% dari hasil diambil. Anggapan PostgreSQL pada angka baris diambil untuk kursor permintaan dikendalikan dengan pilihan cursor_tuple_fraction.

Manual-menentukan nilai-nilai dari primary key peningkatan-otomatis¶

Django menggunakan SERIAL data type PostgreSQL untuk menyimpan peningkatan-otomatis primary key. Sebuah kolom SERIAL dihitung dengan nilai-nilai dari sequence yang menjaga nilai ketersediaan selanjutnya. Secara manual memberikan nilai pada sebuah bidang peningkatan-otomatis tidak memperbaharui urutan bidang, yang mungkin kemudian menyebabkan sebuah pertentangan. Sebagai contoh:

>>> from django.contrib.auth.models import User
>>> User.objects.create(username='alice', pk=1)
<User: alice>
>>> # The sequence hasn't been updated; its next value is 1.
>>> User.objects.create(username='bob')
...
IntegrityError: duplicate key value violates unique constraint
"auth_user_pkey" DETAIL:  Key (id)=(1) already exists.

Jika anda butuh menentukan nilai-nilai seperti itu, setel kembali urutan setelah itu menghindari menggunakan sebuah nilai yang sudah dalam tabel. Perintah pengelolaan sqlsequencereset membangkitkan pernyataan SQL untuk melakukan itu.

Cetakan percobaan basisdata¶

Anda dapat menggunakan pengaturan TEST['TEMPLATE'] untuk menentukan template (misalnya 'template0') dari mana membuat basis data percobaan.

Mempercepat penjalanan percobaan dengan pengaturan tidak-tahan-lama¶

Anda dapat mempercepat waktu penjalanan percobaan dengan configuring PostgreSQL to be non-durable.

Versi dukungan¶

Django mendukung MySQL 5.6 dan lebih tinggi.

Fitur inspectdb Django menggunakan basisdata information_schema, yang mengandung rincian data pada semua skema basisdata.

Django mengharapkan basisdata untuk mendukung Unicode (UTF-8 encoding) dan menugaskan ke itu tugas dari memaksa transaksi dan keutuhan referensial. itu adalah penting untuk waspada dari fakta bahwa dua terakhir sebenarnya tidak dipaksa oleh MySQL ketika menggunakan mesin penyimpanan, lihat bagian selanjutnya.

Mesin penyimpanan¶

MySQL mempunyai beberapa storage engines. Anda dapat merubah mesin penyimpanan awalan dalam konfigurasi peladen.

Mesin penyimpanan awalan MySQL adalah InnoDB. Mesin ini sepenuhnya transaksional dan mendukung acuan foreign key. Itu adalah pilihan dianjurkan. Bagaimanapun penghitung peningkatan otomatis InnoDB hilang pada pemulaian kembali MySQL karena itu tidak ingat nilai AUTO_INCREMENT, daripada membuat kembali itu sebagai "max(id)+1". Ini mungkin menghasilkan sebuah penggunaan kembali tidak sengaja dari nilai AutoField.

Kekurangan utama dari MyISAM adalah bahwa itu tidak mendukung transaksi atau memaksa batasan foreign-key.

Driver API DB MySQL¶

MySQL mempunyai sepasang driver yang menerapkan API Basisdata Python digambarkan dalam PEP 249:

• mysqlclient adalah pengemudi asli. Itu adalah pilihan dianjurkan.
• MySQL Connector/Python adalah murni pengemudi Python dari Oracle yang tidak mewajibkan pustaka klien MySQL atau modul Python apapun diluar dari pustaka standar.

Pengemudi ini adalah untaian-aman dan menyediakan hubungan menyatukan.

Sebagai tambahan pada pengemudi API DB, Django butuh sebuah penyadur mengakses pengemudi basisdata dari ORM nya. Django menyediakan sebuah penyadur untuk mysqlclient selagi Penghubung/Python MySQL termasuk its own.

Pengertian zona waktu¶

Jika anda berencana menggunakan dukungan timezone Django, gunakan mysql_tzinfo_to_sql untuk memuat tabel zona waktu kedalam basisdata MySQL. Ini harus dilakukan hanya sekali untuk peladen MySQL anda, bukan per basisdata.

Membuat basisdata anda¶

Anda dapat membuat basisdata anda menggunakan alat baris-perintah dan SQL ini:

CREATE DATABASE <dbname> CHARACTER SET utf8;

Ini memastikan semua tabel dan kolom akan menggunakan UTF-8 secara awal.

Menyambung ke basisdata¶

Mengacu ke pengaturan dokumentasi.

Pengaturan hubungan digunakan dalam urutan ini:

1. OPTIONS.
2. NAME, USER, PASSWORD, HOST, PORT
3. Berkas pilihan MySQL.

Dengan kata lain, jika anda mensetel nama dari basisdata dalam OPTIONS, ini akan mengambil hak lebih tinggi terhadap NAME, yang akan menimpa apapin dalam MySQL option file.

Ini adalah contoh konfigurasi yang menggunakan berkas pilihan MySQL:

# settings.py
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'OPTIONS': {
            'read_default_file': '/path/to/my.cnf',
        },
    }
}


# my.cnf
[client]
database = NAME
user = USER
password = PASSWORD
default-character-set = utf8

Beberapa MySQLdb connection options lain mungkin berguna, seperti ssl, init_command, dan sql_mode.

Membuat tabel anda¶

Ketika Django membangkitkan skema, itu tidak menentukan sebuah mesin penyimpanan, jadi tabel-tabel akan dibuat dengan apapun mesin penyimpanan awalan paladen basisdata anda dikonfigurasikan. Pemecahan paling mudah adalah mensetel mesin penyimpanan awalan peladen basisdata anda pada mesin yang diinginkan.

Jika anda sedang menggunakan layanan rumahan dan tidak dapat merubah mesin penyimpanan awalan peladen, anda memiliki sepasang pilihan.

• Setelah tabel dibuat, jalankan sebuah pernyataan ALTER TABLE untuk merubah sebuah tabel ke mesin penyimpanan baru (seperti InnoDB):

  ALTER TABLE <tablename> ENGINE=INNODB;
  

  Ini dapat membosankan jika anda memiliki banyak tabel.

• Pilihan lain adalah menggunakan pilihan init_command untuk MySQLdb sebelum membuat tabel anda:

  'OPTIONS': {
     'init_command': 'SET default_storage_engine=INNODB',
  }
  

  Ini menyetel mesin penyimpanan awalan diatas hubungan ke basisdata. Setelah tabel-tabel anda telah dibuat, anda harus memindahkan pilihan ini ketika itu menambahkan sebuah permintaan yaitu hanya dibutuhkan selama pembautan tabel pada setiap hubungan basisdata.

Nama tabel¶

Ada known issues di bahkan versi terakhir dari MySQL yang dapat menyebabkan kasus dari nama tabel dirubah ketika pernyataan SQL tertentu dijalankan dibawah kondisi tertentu. Itu dianjurkan bahwa anda menggunakan nama tabel huruf kecil, jika memungkinkan, untuk menghindari masalah apapun yang mungkin muncul dari perilaku ini. Django menggunakan nama tabel huruf kecil ketika it membangkitkan-otomatis nama tabel dari mdoel, jadi ini adalah pertimbangan utama jika anda sedang menimpa nama tabel melalui parameter db_table.

Savepoint¶

Kedua ORM Django dan MySQL (ketika menggunakan InnoDB storage engine) mendukung basisdata savepoints.

If you use the MyISAM storage engine please be aware of the fact that you will receive database-generated errors if you try to use the savepoint-related methods of the transactions API. The reason for this is that detecting the storage engine of a MySQL database/table is an expensive operation so it was decided it isn't worth to dynamically convert these methods in no-op's based in the results of such detection.

Catatan pada tabel khusus¶

ALTER TABLE `your_table` MODIFY `your_datetime_column` DATETIME(6)

Penguncian baris dengan QuerySet.select_for_update()¶

MySQL and MariaDB do not support some options to the SELECT ... FOR UPDATE statement. If select_for_update() is used with an unsupported option, then a NotSupportedError is raised.

When using select_for_update() on MySQL, make sure you filter a queryset against at least set of fields contained in unique constraints or only against fields covered by indexes. Otherwise, an exclusive write lock will be acquired over the full table for the duration of the transaction.

Typecasting otomatis dapat menggunakan hasil tidak diharapkan¶

Ketika melakukan sebuah permintaan pada jenis string, tetapi dengan sebuah nilai integer, MySQL akan memaksa jenis-jenis dari semua nilai dalam tabel pada sebuah integer sebelum melakukan perbandingan. Jika tabel-tabel anda mengandung nilai 'abc', 'def' dan permintaan anda untuk WHERE mycolumn=0, kedua baris akan cocok. Mirip, WHERE mycolumn=1 akan cocok nilai 'abc1'. Karena itu, bidang-bidang jenis string disertakan dalam Django akan selalu melempar nilai ke sebuah string sebelum menggunakan itu dalam sebuah permintaan.

Jika anda menerapkan bdiang model penyesuaian yang mewarisi dari Field directly, adalah menimpa get_prep_value(), atau menggunakan RawSQL, extra(), atau raw(), anda harus memastikan bahwa anda melakukan typecasting yang sesuai.

Substring matching and case sensitivity¶

Untuk semua versi SQLite, ada beberapa perilaku sedikit kontra-intuitif ketika berusaha mencocokkan beberapa jenis string. Ini dibangkitkan ketika menggunakan penyaring iexact atau contains dalam Queryset. Perilaku ini memecah menjadi dua kasus:

1. For substring matching, all matches are done case-insensitively. That is a filter such as filter(name__contains="aa") will match a name of "Aabb".

2. For strings containing characters outside the ASCII range, all exact string matches are performed case-sensitively, even when the case-insensitive options are passed into the query. So the iexact filter will behave exactly the same as the exact filter in these cases.

Some possible workarounds for this are documented at sqlite.org, but they aren't utilized by the default SQLite backend in Django, as incorporating them would be fairly difficult to do robustly. Thus, Django exposes the default SQLite behavior and you should be aware of this when doing case-insensitive or substring filtering.

Decimal handling¶

SQLite has no real decimal internal type. Decimal values are internally converted to the REAL data type (8-byte IEEE floating point number), as explained in the SQLite datatypes documentation, so they don't support correctly-rounded decimal floating point arithmetic.

Kesalahan "Basisdata terkunci"¶

SQLite berarti menjadi basisdata ringan, dan demikian tidak dapat mendukung bersamaan tingkat tinggi. Kesalahan OperationalError: bassidata dikunci menunjukkan bahwa aplikasi anda berpengalaman lebih bersamaan daripada sqlite dapat tangani dalam konfigurasi awalan. Kesalahan ini berarti bahwa satu antrian atau proses mempunyai sebuah kunci khusus pada hubungan basisdata dan waktu habis antrian lain menunggu untuk kunci dibebaskan.

Pembungkus SQLite Python mempunyai nilai waktu habis awalan yang menentukan seberapa lama detik urutan diizinkan untuk menunggu penguncian sebelum itu berakhir dan memunculkan kesalahan OperationalError: database is locked.

Jika anda mendapatkan kesalahan ini, anda dapat menyelesaikannya dengan:

• Berganti ke backend basisdata lain. Pada titik tertentu SQLite menjadi terlalu "ringan" untuk aplikasi dunia-sebenarnya, dan urutan kesalahan bersamaan ini menunjukkan anda telah mencapat titik itu.

• Menulis kembali kode anda untuk mengurangi bersamaan dan memastikan transaksi basisdata adalah berumur-pendek.

• Meningkatkan nilai waktu habis awalan dengan mengatur pilihan basisdata timeout:

  'OPTIONS': {
      # ...
      'timeout': 20,
      # ...
  }
  

  This will make SQLite wait a bit longer before throwing "database is locked" errors; it won't really do anything to solve them.

QuerySet.select_for_update() tidak didukung¶

SQLite tidak mendukung sintaksis SELECT ... FOR UPDATE. Memanggil itu tidak akan memiliki pengaruh.

Gaya parameter "pyformat" dalam permintaan mentah tidak didukung¶

For most backends, raw queries (Manager.raw() or cursor.execute()) can use the "pyformat" parameter style, where placeholders in the query are given as '%(name)s' and the parameters are passed as a dictionary rather than a list. SQLite does not support this.

Pengucilan ketika menggunakan QuerySet.iterator()¶

There are special considerations described in Isolation In SQLite when modifying a table while iterating over it using QuerySet.iterator(). If a row is added, changed, or deleted within the loop, then that row may or may not appear, or may appear twice, in subsequent results fetched from the iterator. Your code must handle this.

Menyambung ke basisdata¶

Untuk menghubungkan menggunakan nama layanan dari basisdata Oracle anda, berkas settings.py anda harus terlihat seperti ini:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.oracle',
        'NAME': 'xe',
        'USER': 'a_user',
        'PASSWORD': 'a_password',
        'HOST': '',
        'PORT': '',
    }
}

Dalam kasus ini, anda harus meninggakan kedua HOST dan PORT kosong. Bagaimanapun, jika anda tidak menggunakan berkas tnsnames.ora atau metode penamaan mirip dan ingin berhubungan menggunakan SID ("xe" dalam contoh ini), kemudian isi kedua HOST dan PORT seperti itu:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.oracle',
        'NAME': 'xe',
        'USER': 'a_user',
        'PASSWORD': 'a_password',
        'HOST': 'dbprod01ned.mycompany.com',
        'PORT': '1540',
    }
}

Anda harus salah andara mendukung kedua HOST and PORT, atau meninggalkan kedua sebagai string kosong. Django akan menggunakan deskriptor hubungan berbeda tergantung pada pilihan itu.

'NAME': 'localhost:1521/orclpdb1',

'NAME': (
    '(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))'
    '(CONNECT_DATA=(SERVICE_NAME=orclpdb1)))'
),

Pilihan urutan¶

Jika anda berencana menjalankan Django dalam lingkungan banyak antrian (yaitu Apache menggunakan modul MPM awalan pada sistem operasi modern apapun), kemudian anda harus mensetel pilihan threaded dari konfigurasi basisdata Oracle anda menjadi True:

'OPTIONS': {
    'threaded': True,
},

Kegagalam melakukan ini akan menyebabkan tabrakan dan perilaku ganjil lain.

INSERT ... RETURNING INTO¶

Secara awalan, backend Oracle menggunakan klausa RETURNING INTO untuk efesian mengambil nilai dari AutoField ketika memasukkan baris baru. Perilaku ini mungkin menghasilkan sebuah DatabaseError dallam pengaturan tidak biasa tertentu, seperti ketika memasukkan kedalam tabel jauh, atau kedalam sebuah tampilan dengan sebuah pemicu INSTEAD OF. Klausa RETURNING INTO dapat ditiadakan dengan mengatur pilihan use_returning_into dari konfigurasi basisdata menjadi False:

'OPTIONS': {
    'use_returning_into': False,
},

Dalam kasus ini, backend Oracle akan menggunakan permintaan SELECT terpisah untuk mengambil nilai-nilai AutoField.

Masalah penamaan¶

Oracle memaksakan batasan panjang nama dari 30 karakter. Untuk mengakomodasi ini, backend memotong penciri basisdata agar cocok, mengganti empat karakter akhir dari nama terpotong dengan sebuah nilai campuran MD5 berulang. Sebagai tambahan, backend merubah penciri basisdata menjadi semua-huruf-besar.

Untuk mencegah perubahan ini (ini biasanya hanya membutuhkan ketika berhubungan dengan basisdata warisan atau mengakses tabel-tabel yang milik pengguna lain), gunakan sebuah nama terkutip sebagai nilai untuk db_table:

class LegacyModel(models.Model):
    class Meta:
        db_table = '"name_left_in_lowercase"'

class ForeignModel(models.Model):
    class Meta:
        db_table = '"OTHER_USER"."NAME_ONLY_SEEMS_OVER_30"'

Nama terkutip dapat juga digunakan dengan backend basisdata didukung lain Django; kecuali untuk Oracle, bagaimanapun, kutipan tidak mempunyai pengaruh.

Ketika menjalankan migrate, sebuah kesalahan ORA-06552 mungkin ditemui jika kata kunci Oracle tertentu digunakan sebagai nama dari sebuah bidang model atau nilai dari sebuah pilihan db_column. Django mengutip semua penciri digunakan dalam permintaan untuk mencegah kebanyakan masalah seperti itu, tetapi kesalahan ini dapat masih muncul ketika sebuah jenis data oracle digunakan sebagai sebuah nama kolom. Khususnya, hati-hati menghindari penggunaan nama-nama date, timestamp, number atau float sebagai nama bidang.

String NULL dan kosong¶

Django umumnya memilih menggunakan string kosong ('') daripada NULL, tetapi Oracle memperlakukan keduanya mirip. Untuk menyiasati ini, backend Oracle mengabaikan pilihan null tersirat pada bidang yang mempunyai string kosong sebagai nilai kemungkinan dan membangkitkan DDL seolah-olah null=True. Ketika mengambil dari basisdata, itu dianggap bahwa sebuah nilai NULL dalam satu dari bidang-bidang ini sangat berarti string kosong, dan data secara diam dirubah untuk mencerminkan anggapan ini.

Batasan TextField¶

Backend Oracle menyimpan TextFields sebagai kolom NCLOB. Oracle memaksakan beberapa pembatasan pada penggunaan seperti kolom LOB secara umum:

• Kolom LOB tidak boleh digunakan sebagai primary key.
• Kolom LOB tidak boleh digunakan sebagai indeks.
• Kolom LOB mugnkin tidak digunakan dalam daftar SELECT DISTINCT. Ini berarti bahwa mencoba menggunakan metode QuerySet.distinct pada sebuah model yang menyertakan kolom TextField akan menghasilkan dalam sebuah kesalahan ORA-00932 ketika berjalan terhadap Oracle. Sebagai pemecahannya, gunakan metode QuerySet.defer dalam berhubungan dengan distinct() untuk mencegah kolom TextField dari menjadi disertakan dalam daftar SELECT DISTINCT.