@@ -50,13 +50,14 @@ Indexes
5050
5151{+django-odm+} does not support the following index functionalities:
5252
53- - Creation of ``$vectorSearch`` and ``$search`` indexes through the Django
53+ - Creating ``$vectorSearch`` and ``$search`` indexes through the Django
5454 Indexes API
5555- Creating geospatial indexes through the Django Indexes API
5656- Updating indexes in ``EmbeddedModelFields`` after model creation
5757
5858To learn how to run unsupported database operations by operating directly on
59- your ``MongoClient`` instance, see the :ref:`django-client-operations` guide.
59+ your ``MongoClient`` instance, see :ref:`django-client-operations` in the
60+ Perform Raw Database Queries.
6061
6162Fields
6263~~~~~~
6667- ``ArrayField``
6768
6869 - {+django-odm+} does not support ``ArrayField`` polymorphism.
69- - {+django-odm+} does not support ``EmbeddedModelField`` within an ``ArrayField``.
70+ - {+django-odm+} does not support nesting an ``EmbeddedModelField`` within an ``ArrayField``.
7071
7172- ``EmbeddedModelField``
7273
@@ -82,28 +83,28 @@ Fields
8283 return both JSON and SQL ``null`` values.
8384 - Some queries with ``Q`` objects, such as ``Q(value__foo="bar")``, might
8485 not work as expected.
85- - Filtering with a ``None`` key incorrectly returns objects in which a key
86+ - Filtering for ``None`` values incorrectly returns objects in which a field
8687 does not exist.
8788
8889- ``DateTimeField``
8990
9091 - {+django-odm+} does not support microsecond granularity for
91- ``DateTimeField``.
92+ ``DateTimeField``.
9293
9394- ``DurationField``
9495
95- - The ``DurationField`` stores milliseconds rather than microseconds.
96+ - ``DurationField`` stores milliseconds rather than microseconds.
9697
9798- ``ForeignKey``
9899
99100 - When possible, you should use an ``EmbeddedModelField`` instead of a
100101 ``ForeignKey`` field to avoid using ``$lookup`` operations. An
101- ``EmbeddedModelField`` emulates a MongoDB embedded document, and performs
102+ ``EmbeddedModelField`` emulates a MongoDB embedded document and performs
102103 better than a ``ForeignKey`` field. To learn more about how to reduce
103104 ``$lookup`` operations, see the :atlas:`Reduce $lookup Operations
104105 </schema-suggestions/reduce-lookup-operations/>` guide in the Atlas
105106 documentation.
106- - The performance of `CASCADE deletes <{+django-docs+}/ref/models/fields/#foreignkey >`__
107+ - Performance of `CASCADE deletes <{+django-docs+}/ref/models/fields/#django.db.models.CASCADE >`__
107108 on a ``ForeignKey`` field is not as performant as using an
108109 ``EmbeddedModelField``.
109110
@@ -133,12 +134,13 @@ Geospatial Queries
133134- {+django-odm+} does not have any Django lookup operators for MongoDB-specific
134135 geospatial queries.
135136
136- Aggregation operators
137+ Aggregation Operators
137138~~~~~~~~~~~~~~~~~~~~~
138139
139- {+django-odm+} does not contain any custom Django Field lookups for the MongoDB
140- aggregation framework. Instead, use the ``raw_aggregate`` method. For more
141- information on the ``raw_aggregate`` method.
140+ {+django-odm+} does not contain any custom Django field lookups for the MongoDB
141+ aggregation framework. Instead, use the ``raw_aggregate()`` method. For more
142+ information on the ``raw_aggregate()`` method, see
143+ the :ref:`django-raw-queries` guide.
142144
143145.. TODO: Link to aggregation
144146
0 commit comments