django-cachalot/docs/limits.rst

40 lines
1.3 KiB
ReStructuredText
Raw Normal View History

2014-10-28 22:44:28 +00:00
.. _limits:
Limits
------
Locmem
......
Locmem is a just a dict stored in a single Python process.
Its not shared between processes, so dont use locmem with django-cachalot
in a multi-processes project, if you use RQ or Celery for instance.
2014-11-04 00:17:35 +00:00
.. _Raw queries limits:
2014-10-28 22:44:28 +00:00
2014-11-04 00:17:35 +00:00
Raw SQL queries
...............
2014-10-28 22:44:28 +00:00
2014-11-04 00:17:35 +00:00
.. note::
Dont worry if you dont understand what follow. That probably means you
dont use raw queries, and therefore are not directly concerned by
those potential issues.
By default, django-cachalot tries to invalidate its cache after a raw query.
It detects if the raw query contains ``UPDATE``, ``INSERT`` or ``DELETE``,
and then invalidates the tables contained in that query by comparing
with models registered by Django.
This is quite robust, so if a query is not invalidated automatically
2014-11-04 00:19:20 +00:00
by this system, please :ref:`send a bug report <reporting>`.
2014-11-04 00:17:35 +00:00
In the meantime, you can use :ref:`the API <API>` to manually invalidate
the tables where data has changed.
However, this simple system can be too efficient in some cases and lead to
unwanted extra invalidations.
In such cases, you may want to partially disable this behaviour by
:ref:`dynamically overriding settings <Dynamic overriding>` to set
:ref:`CACHALOT_INVALIDATE_RAW` to ``False``.
After that, use :ref:`the API <API>` to manually invalidate the tables
you modified.