Skip to content

Commit d17b6b1

Browse files
committed
Added sections for readability
1 parent caa4e44 commit d17b6b1

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

articles/search/search-how-to-define-index-projections.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -140,14 +140,16 @@ This example is similar to the [RAG tutorial](tutorial-rag-build-solution-index-
140140

141141
## Add index projections to a skillset
142142

143-
Index projections are defined inside a skillset definition and are primarily defined as an array of `selectors`, where each selector corresponds to a different target index on the search service. Each selector requires the following parameters as part of its definition:
143+
Index projections are defined inside a skillset definition and are primarily defined as an array of `selectors`, where each selector corresponds to a different target index on the search service. This section describes each parameter and includes [steps and examples](#how-to-specify-an-index-projections-definition) for setting up the projections.
144+
145+
### Parameter reference
144146

145147
| Index projection parameters | Definition |
146148
|----------------------------|------------|
147149
| `selectors` | Parameters for the main search corpus, usually the one designed around chunks. |
148150
| `projectionMode` | An optional parameter providing instructions to the indexer. The only valid value for this parameter is `skipIndexingParentDocuments`, and it's used when the chunk index is the primary search corpus and you need to specify whether parent fields are indexed as individual search documents within the chunked index. If you don't set `skipIndexingParentDocuments`, you get extra search documents in your index that are null for chunks, but populated with parent fields only. For example, if five documents contribute 100 chunks to the index, then the number of documents in the index is 105. The five documents created or parent fields have nulls for chunk (child) fields, making them substantially different from the bulk of the documents in the index. We recommend `projectionMode` set to `skipIndexingParentDocument`. |
149151

150-
Selectors also have parameters.
152+
Each selector requires the following parameters as part of its definition:
151153

152154
| Selector parameters | Definition |
153155
|-----------|------------|
@@ -162,6 +164,10 @@ This requirement is in contrast with other field mapping conventions in Azure AI
162164

163165
<!-- Avoid creating a field mapping for the parent key field. Doing so disrupts change tracking and synchronized data refresh. -->
164166

167+
### How to specify an `indexProjections` definition
168+
169+
Choose the tab for the API syntax. There's currently no portal support for setting up projections, other than editing the skillset JSON definition.
170+
165171
#### [**REST**](#tab/rest-create-index-projection)
166172

167173
Index projections are generally available. We recommend the most recent stable API:

0 commit comments

Comments
 (0)