Skip to content

Commit 15a80b0

Browse files
authored
Update search-indexer-field-mappings.md
Updated advanced scenarios of field mappings without samples
1 parent 2a21dd6 commit 15a80b0

File tree

1 file changed

+21
-3
lines changed

1 file changed

+21
-3
lines changed

articles/search/search-indexer-field-mappings.md

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,7 @@ Field mappings apply to:
3030

3131
+ Physical data structures on both sides of the data path. Logical data structures created by skills reside only in memory. Use [outputFieldMappings](cognitive-search-output-field-mapping.md) to map in-memory nodes to output fields in a search index.
3232

33-
+ Parent AI Search indexes only.
34-
- To populate a [knowledge store](knowledge-store-concept-intro.md), use [projections](knowledge-store-projections-examples.md) for data path configuration.
35-
- To map parent document fields to a secondary index, which contains "child" documents or "chunks" for "one-to-many" document scenarios (such as data chunking/splitting), use [index projections](index-projections-concept-intro.md).
33+
+ Parent AI Search indexes only. For "secondary" indexes with "child" documents or "chunks", refer to the [advanced field mapping scenarios]().
3634

3735
+ Top-level search fields only, where the `targetFieldName` is either a simple field or a collection. A target field can't be a complex type.
3836

@@ -451,6 +449,26 @@ The field mapping needs to be specified as shown below.
451449
]
452450
```
453451

452+
## Advanced field mapping scenarios
453+
454+
In scenarios where you have "one-to-many" document relationships, such as data chunking or splitting, follow these guidelines for mapping fields from parent documents to "child" documents (chunks):
455+
456+
### 1. Skipping parent document indexing
457+
458+
If you are skipping the indexing of parent documents (by setting `projectionMode` to `skipIndexingParentDocuments` in the skillset's `indexProjections`), use [index projections](index-projections-concept-intro.md) to map fields from the parent documents to the "child" documents.
459+
460+
### 2. Indexing both parent and "child" documents
461+
462+
If you are indexing both parent documents and "child" documents:
463+
+ Use field mappings to map fields to the parent documents.
464+
+ Use [index projections](index-projections-concept-intro.md) to map fields to the "child" documents.
465+
466+
### 3. Mapping function-transformed values to both parent and/or "child" documents
467+
468+
If a field in the parent document requires a transformation (using the mapping functions](#mappingFunctions) such as encoding) and needs to be mapped to the parent and/or "child" documents:
469+
+ Apply the transformation using field mappings' functions in the indexer.
470+
+ Use [index projections](index-projections-concept-intro.md) in the skillset to map the transformed field to the "child" documents.
471+
454472
## See also
455473

456474
+ [Supported data types in Azure AI Search](/rest/api/searchservice/supported-data-types)

0 commit comments

Comments
 (0)