index.txt 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. ``django.contrib.postgres``
  2. ===========================
  3. .. module:: django.contrib.postgres
  4. :synopsis: PostgreSQL-specific fields and features
  5. PostgreSQL has a number of features which are not shared by the other databases
  6. Django supports. This optional module contains model fields and form fields for
  7. a number of PostgreSQL specific data types.
  8. Psycopg2 2.5 or higher is required.
  9. .. note::
  10. Django is, and will continue to be, a database-agnostic web framework. We
  11. would encourage those writing reusable applications for the Django
  12. community to write database-agnostic code where practical. However, we
  13. recognize that real world projects written using Django need not be
  14. database-agnostic. In fact, once a project reaches a given size changing
  15. the underlying data store is already a significant challenge and is likely
  16. to require changing the code base in some ways to handle differences
  17. between the data stores.
  18. Django provides support for a number of data types which will
  19. only work with PostgreSQL. There is no fundamental reason why (for example)
  20. a ``contrib.mysql`` module does not exist, except that PostgreSQL has the
  21. richest feature set of the supported databases so its users have the most
  22. to gain.
  23. .. toctree::
  24. :maxdepth: 2
  25. aggregates
  26. fields
  27. forms
  28. functions
  29. lookups
  30. operations
  31. validators