Merge pull request #183214 from HeidiSteen/heidist-indexer

[azure search] indexer edits, power query connector image formatting

Author: PRMerger12

articles/search/search-how-to-index-power-query-data-sources.md

@@ -9,7 +9,7 @@ manager: nitinme
 
 ms.service: cognitive-search
 ms.topic: conceptual
-ms.date: 05/25/2021
+ms.date: 12/17/2021
 ms.custom: references_regions
 ---
 
@@ -66,8 +66,8 @@ After you're approved for the preview, the Azure Cognitive Search team will prov
 ### Step 3 – Select your data source
 There are a few data sources that you can pull data from using this preview. All data sources that use Power Query will include a "Powered By Power Query" on their tile. 
 Select your data source. 
- 
-![Select a data source](./media/search-power-query-connectors/power-query-import-data.png "Select a data source")
+
+:::image type="content" source="media/search-power-query-connectors/power-query-import-data.png" alt-text="Screenshot of the Select a data source page." border="true":::
 
 Once you've selected your data source, select **Next: Configure your data** to move to the next section.
 
@@ -82,8 +82,8 @@ Once you've provided your connection credentials, select **Next**.
 
 ### Step 5 – Select your data
 The import wizard will preview various tables that are available in your data source. In this step you'll check one table that contains the data you want to import into your index.
- 
-![Preview your data](./media/search-power-query-connectors/power-query-preview-data.png "Preview your data")
+
+:::image type="content" source="media/search-power-query-connectors/power-query-preview-data.png" alt-text="Screenshot of data preview." border="true":::
 
 Once you've selected your table, select **Next**.
 
@@ -92,7 +92,7 @@ Power Query connectors provide you with a rich UI experience that allows you to
 
 It's not required that you transform your data before importing it into Azure Cognitive Search.
 
-![Transform your data](./media/search-power-query-connectors/power-query-transform-your-data.png "Transform your data") 
+:::image type="content" source="media/search-power-query-connectors/power-query-transform-your-data.png" alt-text="Screenshot of Transform your data page." border="true":::
 
 For more information about transforming data with Power Query, look at [Using Power Query in Power BI Desktop](/power-query/power-query-quickstart-using-power-bi). 
 
@@ -101,8 +101,9 @@ Once you're done transforming your data, select **Next**.
 ### Step 7 – Add Azure Blob storage
 The Power Query connector preview currently requires you to provide a blob storage account. This step only exists with the initial gated preview. This blob storage account will serve as temporary storage for data that moves from your data source to an Azure Cognitive Search index.
 
-We recommend providing a full access storage account connection string: 
-```
+We recommend providing a full access storage account connection string:
+ 
+```JSON
 { "connectionString" : "DefaultEndpointsProtocol=https;AccountName=<your storage account>;AccountKey=<your account key>;" }
 ```
 
@@ -124,7 +125,7 @@ Review the description of index attributes and language analyzers for more infor
 
 Take a moment to review your selections. Once you run the wizard, physical data structures are created and you won't be able to edit most of the properties for these fields without dropping and recreating all objects.
 
-![Create your index](./media/search-power-query-connectors/power-query-index.png "Create your index")
+:::image type="content" source="media/search-power-query-connectors/power-query-index.png" alt-text="Screenshot of Create your index page." border="true":::
 
 When complete, select **Next: Create an Indexer**.
 
@@ -135,7 +136,7 @@ The output of the Import data wizard is an indexer that crawls your data source
 
 When creating the indexer, you can optionally choose to run the indexer on a schedule and add change detection. To add change detection, designate a 'high water mark' column.
 
-![Create your indexer](./media/search-power-query-connectors/power-query-indexer-configuration.png "Create your indexer")
+:::image type="content" source="media/search-power-query-connectors/power-query-indexer-configuration.png" alt-text="Screenshot of Create your indexer page." border="true":::
 
 Once you've finished filling out this page select **Submit**.
 

articles/search/search-indexer-overview.md

@@ -8,18 +8,18 @@ author: HeidiSteen
 ms.author: heidist
 ms.service: cognitive-search
 ms.topic: conceptual
-ms.date: 01/29/2021
+ms.date: 12/17/2021
 ---
 
 # Indexers in Azure Cognitive Search
 
-An *indexer* in Azure Cognitive Search is a crawler that extracts searchable text and metadata from an external Azure data source and populates a search index using field-to-field mappings between source data and your index. This approach is sometimes referred to as a 'pull model' because the service pulls data in without you having to write any code that adds data to an index. Indexers also drive the [AI enrichment](cognitive-search-concept-intro.md) capabilities of Cognitive Search, integrating external processing of content en route to an index.
+An *indexer* in Azure Cognitive Search is a crawler that extracts searchable content from cloud data sources and populates a search index using field-to-field mappings between source data and a search index. This approach is sometimes referred to as a 'pull model' because the search service pulls data in without you having to write any code that adds data to an index. Indexers also drive the [AI enrichment](cognitive-search-concept-intro.md) capabilities of Cognitive Search, integrating external processing of content en route to an index.
 
-Indexers are Azure-only, with individual indexers for [Azure SQL](search-howto-connecting-azure-sql-database-to-azure-search-using-indexers.md), [Azure Cosmos DB](search-howto-index-cosmosdb.md), [Azure Table Storage](search-howto-indexing-azure-tables.md) and [Blob Storage](search-howto-indexing-azure-blob-storage.md). When configuring an indexer, you'll specify a data source (origin), as well as an index (destination). Several sources, such as Blob storage, have additional configuration properties specific to that content type.
+Indexers are cloud-only, with individual indexers for supported data sources. When configuring an indexer, you'll specify a data source (origin) and a search index (destination). Several sources, such as Azure Blob storage, have additional configuration properties specific to that content type.
 
 You can run indexers on demand or on a recurring data refresh schedule that runs as often as every five minutes. More frequent updates require a ['push model'](search-what-is-data-import.md) that simultaneously updates data in both Azure Cognitive Search and your external data source.
 
-## Usage scenarios
+## How to use indexers
 
 You can use an indexer as the sole means for data ingestion, or as part of a combination of techniques that load and optionally transform or enrich content along the way. The following table summarizes the main scenarios.
 
@@ -49,10 +49,12 @@ Indexers crawl data stores on Azure and outside of Azure.
 + [Salesforce Reports](search-how-to-index-power-query-data-sources.md) (in preview)
 + [Smartsheet](search-how-to-index-power-query-data-sources.md) (in preview)
 + [Snowflake](search-how-to-index-power-query-data-sources.md) (in preview)
-+ [SQL Managed Instance](search-howto-connecting-azure-sql-mi-to-azure-search-using-indexers.md)
++ [Azure SQL Managed Instance](search-howto-connecting-azure-sql-mi-to-azure-search-using-indexers.md)
 + [SQL Server on Azure Virtual Machines](search-howto-connecting-azure-sql-iaas-to-azure-search-using-indexers.md)
 
-Indexer connections to remote data sources can be made using standard Internet connections (public) or encrypted private connections when you use Azure virtual networks for client apps. You can also set up connections to authenticate using a trusted service identity. For more information about secure connections, see [Granting access via private endpoints](search-indexer-securing-resources.md#granting-access-via-private-endpoints) and [Connect to a data source using a managed identity](search-howto-managed-identities-data-sources.md).
+Indexers accept flattened row sets, such as a table or view, or items in a container or folder. In most cases, it creates one search document per row, record, or item.
+
+Indexer connections to remote data sources can be made using standard Internet connections (public) or encrypted private connections when you use Azure virtual networks for client apps. You can also set up connections to authenticate using a managed identity. For more information about secure connections, see [Granting access via private endpoints](search-indexer-securing-resources.md#granting-access-via-private-endpoints) and [Connect to a data source using a managed identity](search-howto-managed-identities-data-sources.md).
 
 ## Stages of indexing