mirror of
https://github.com/django/django.git
synced 2025-08-04 10:59:45 +00:00
Fixed #26610 -- Added CITextField to contrib.postgres.
This commit is contained in:
parent
7eda99f03f
commit
094d630ae8
11 changed files with 110 additions and 10 deletions
|
@ -250,6 +250,26 @@ At present using :attr:`~django.db.models.Field.db_index` will create a
|
|||
A more useful index is a ``GIN`` index, which you should create using a
|
||||
:class:`~django.db.migrations.operations.RunSQL` operation.
|
||||
|
||||
``CITextField``
|
||||
===============
|
||||
|
||||
.. class:: CITextField(**options)
|
||||
|
||||
.. versionadded:: 1.11
|
||||
|
||||
This field is a subclass of :class:`~django.db.models.CharField` backed by
|
||||
the citext_ type, a case-insensitive character string type. Read about `the
|
||||
performance considerations`_ prior to using this field.
|
||||
|
||||
To use this field, setup the ``citext`` extension in PostgreSQL before the
|
||||
first ``CreateModel`` migration operation using the
|
||||
:class:`~django.contrib.postgres.operations.CITextExtension` operation. The
|
||||
code to setup the extension is similar to the example for
|
||||
:class:`~django.contrib.postgres.fields.HStoreField`.
|
||||
|
||||
.. _citext: https://www.postgresql.org/docs/current/static/citext.html
|
||||
.. _the performance considerations: https://www.postgresql.org/docs/current/static/citext.html#AEN169274
|
||||
|
||||
``HStoreField``
|
||||
===============
|
||||
|
||||
|
|
|
@ -27,6 +27,15 @@ the ``django.contrib.postgres.operations`` module.
|
|||
|
||||
Install the ``btree_gin`` extension.
|
||||
|
||||
``CITextExtension``
|
||||
===================
|
||||
|
||||
.. class:: CITextExtension()
|
||||
|
||||
.. versionadded:: 1.11
|
||||
|
||||
Installs the ``citext`` extension.
|
||||
|
||||
``HStoreExtension``
|
||||
===================
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue