Skip to content

Commit 97b1f3a

Browse files
committed
changed intro, added H2
1 parent 3b527ac commit 97b1f3a

File tree

1 file changed

+8
-4
lines changed

1 file changed

+8
-4
lines changed

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

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,22 +18,26 @@ ms.date: 07/29/2024
1818

1919
![Indexer Stages](./media/search-indexer-field-mappings/indexer-stages-field-mappings.png "indexer stages")
2020

21+
This article explains how to set explicit field mappings that establish the data path between source fields in a supported data source and target fields in a search index.
22+
23+
## When to set a field mapping
24+
2125
When an [Azure AI Search indexer](search-indexer-overview.md) loads a search index, it determines the data path using source-to-destination field mappings. Implicit field mappings are internal and occur when field names and data types are compatible between the source and destination. If inputs and outputs don't match, you can define explicit *field mappings* to set up the data path, as described in this article.
2226

2327
Field mappings can also be used for light-weight data conversions, such as encoding or decoding, through [mapping functions](#mappingFunctions). If more processing is required, consider [Azure Data Factory](../data-factory/index.yml) to bridge the gap.
2428

2529
Field mappings apply to:
2630

27-
+ Physical data structures on both sides of the data path (source fields in a [supported data source](search-indexer-overview.md#supported-data-sources) and target fields in a [search index](search-what-is-an-index.md)).
28-
29-
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.
31+
+ 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.
3032

3133
+ Search indexes only. To populate a [knowledge store](knowledge-store-concept-intro.md), use [projections](knowledge-store-projections-examples.md) for data path configuration.
3234

3335
+ 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.
3436

3537
## Supported scenarios
3638

39+
Make sure you're using a [supported data source](search-indexer-overview.md#supported-data-sources) for indexer-driving indexing.
40+
3741
| Use-case | Description |
3842
|----------|-------------|
3943
| Name discrepancy | Suppose your data source has a field named `_city`. Given that Azure AI Search doesn't allow field names that start with an underscore, a field mapping lets you effectively map "_city" to "city". </p>If your indexing requirements include retrieving content from multiple data sources, where field names vary among the sources, you could use a field mapping to clarify the path.|
@@ -51,7 +55,7 @@ Optionally, you might want just a few nodes in the complex structure. To get ind
5155

5256
## Define a field mapping
5357

54-
This section explains how to set up field mappings.
58+
This section explains the steps for setting up field mappings.
5559

5660
### [**REST APIs**](#tab/rest)
5761

0 commit comments

Comments
 (0)