mirror of https://github.com/django/django.git
40 lines
1.5 KiB
Plaintext
40 lines
1.5 KiB
Plaintext
``django.contrib.postgres``
|
|
===========================
|
|
|
|
.. module:: django.contrib.postgres
|
|
:synopsis: PostgreSQL-specific fields and features
|
|
|
|
PostgreSQL has a number of features which are not shared by the other databases
|
|
Django supports. This optional module contains model fields and form fields for
|
|
a number of PostgreSQL specific data types.
|
|
|
|
Psycopg2 2.5 or higher is required, though we highly recommend using the latest
|
|
release. Some fields require higher versions.
|
|
|
|
.. note::
|
|
Django is, and will continue to be, a database-agnostic web framework. We
|
|
would encourage those writing reusable applications for the Django
|
|
community to write database-agnostic code where practical. However, we
|
|
recognize that real world projects written using Django need not be
|
|
database-agnostic. In fact, once a project reaches a given size changing
|
|
the underlying data store is already a significant challenge and is likely
|
|
to require changing the code base in some ways to handle differences
|
|
between the data stores.
|
|
|
|
Django provides support for a number of data types which will
|
|
only work with PostgreSQL. There is no fundamental reason why (for example)
|
|
a ``contrib.mysql`` module does not exist, except that PostgreSQL has the
|
|
richest feature set of the supported databases so its users have the most
|
|
to gain.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
aggregates
|
|
fields
|
|
forms
|
|
functions
|
|
lookups
|
|
operations
|
|
validators
|