DOCSP-49758: Atlas search indexes

Author: norareidy

source/includes/model-data/indexes.py

@@ -3,6 +3,7 @@
 from django.db.models import Q, F
 from django_mongodb_backend.models import EmbeddedModel
 from django_mongodb_backend.fields import EmbeddedModelField, ArrayField
+from django_mongodb_backend.indexes import SearchIndex
 
 class Nutrition(EmbeddedModel):
     calories = models.IntegerField(default=0)
@@ -60,6 +61,15 @@ class Meta:
     ]
 # end-embedded
 
+# start-atlas-search
+class Meta:
+    db_table = "recipes"
+    indexes = [
+        SearchIndex(fields=["title"],
+                     name="title_search_idx"),
+    ]
+# end-atlas-search
+
 # start-partial
 class Meta:
     db_table = "recipes"

source/model-data/indexes.txt

@@ -202,9 +202,41 @@ Advanced Index Configuration
 This section shows how to create the following advanced
 index types:
 
+- :ref:`django-indexes-atlas-search`
 - :ref:`django-indexes-partial`
 - :ref:`django-indexes-unique`
 
+.. _django-indexes-atlas-search:
+
+Atlas Search Indexes
+~~~~~~~~~~~~~~~~~~~~
+
+Atlas Search indexes specify the behavior of an Atlas Search, or a full-text
+search on collections hosted on MongoDB Atlas.
+
+To create an Atlas Search index, assign the ``indexes`` option in your model's
+``Meta`` class to a ``SearchIndex`` object. Pass the following arguments to the
+``SearchIndex()`` constructor:
+
+- ``fields``: The fields you want to index.
+- ``name``: *(Optional)* The name of your Atlas Search index. If you do not
+  specify this argument, {+django-odm+} automatically generates an index name.
+
+The following example updates the ``Recipe`` model's ``Meta`` class to create
+an Atlas Search index named ``"title_search_idx"`` on the ``title`` field:
+
+.. literalinclude:: /includes/model-data/indexes.py
+   :start-after: start-atlas-search
+   :end-before: end-atlas-search
+   :language: python
+   :copyable:
+   :emphasize-lines: 3-6
+
+.. tip::
+
+   To learn more about Atlas Search queries and indexes, see :atlas:`Atlas Search </atlas-search>`
+   in the Atlas documentation.
+
 .. _django-indexes-partial:
 
 Partial Indexes