Skip to content

Commit 13d6f22

Browse files
committed
reordered sections
1 parent 4af60d5 commit 13d6f22

File tree

1 file changed

+16
-19
lines changed

1 file changed

+16
-19
lines changed

articles/search/search-howto-run-reset-indexers.md

Lines changed: 16 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -21,34 +21,17 @@ In Azure Cognitive Search, there are several ways to run an indexer:
2121

2222
This article explains how to run indexers on demand, with and without a reset.
2323

24-
## Run without reset
25-
26-
A [Run Indexer](/rest/api/searchservice/run-indexer) operation will detect and process only what it necessary to synchronize the search index with changes in the underlying data source. Incremental indexing starts by locating an internal high-water mark to find the last updated search document, which becomes the starting point for indexer execution over new and updated documents in the data source.
27-
28-
[Change detection](search-howto-create-indexers.md#change-detection-and-internal-state) is essential for determining what's new or updated in the data source. Indexers use the change detection capabilities of the underlying data source to determine what's new or updated in the data source.
29-
30-
+ Azure Storage has built-in change detection through its LastModified property.
31-
32-
+ Other data sources, such as Azure SQL or Azure Cosmos DB, have to be configured for change detection before the indexer can read new and updated rows.
33-
34-
If the underlying content is unchanged, a run operation has no effect. In this case, indexer execution history will indicate `0\0` documents processed.
35-
36-
You'll need to [reset the indexer](#resetting-indexers) if want to reprocess in full.
37-
3824
## Indexer execution
3925

4026
You can run multiple indexers at one time, but each indexer itself is single-instance. Starting a new instance while the indexer is already in execution produces this error: `"Failed to run indexer "<indexer name>" error: "Another indexer invocation is currently in progress; concurrent invocations are not allowed."`
4127

42-
An indexer job runs in a managed execution environment. Currently, there are two environments. You can't control or configure which environment is used. Azure Cognitive Search determines the environment based on job complexity, duration, and the ability of the service to move an indexer job onto a content processor (some security features block the multi-tenant environment).
28+
An indexer job runs in a managed execution environment. Currently, there are two environments. You can't control or configure which environment is used. Azure Cognitive Search determines the environment based on job composition and the ability of the service to move an indexer job onto a content processor (some [security features](search-indexer-securing-resources.md#indexer-execution-environment) block the multi-tenant environment).
4329

4430
Indexer execution environments include:
4531

4632
+ A private execution environment that runs on search nodes, specific to your search service.
4733

48-
+ A multi-tenant environment with content processors, managed and secured by Microsoft at no extra cost. This environment is used to offload computationally intensive processing, leaving service-specific resources available for routine operations. Whenever possible, most indexer jobs are executed in the multi-tenant environment.
49-
50-
> [!NOTE]
51-
> The multi-tenant environment was initially a way to offload skillset processing. Over time, as the efficiency and benefits of offloading became clear, the use of content processors expanded to include text-based indexing as well.
34+
+ A multi-tenant environment with content processors, managed and secured by Microsoft at no extra cost. This environment is used to offload computationally intensive processing, leaving service-specific resources available for routine operations. Whenever possible, most indexer jobs are executed in the multi-tenant environment.
5235

5336
Indexer limits vary for each environment:
5437

@@ -63,6 +46,20 @@ Indexer limits vary for each environment:
6346

6447
<sup>3</sup> "Indeterminate" means that the limit isn't quantified by the number of jobs. Some workloads, such as skillset processing, can run in parallel which could result in many jobs even though only one indexer is involved. Although the environment doesn't impose constraints, [indexer limits](search-limits-quotas-capacity.md#indexer-limits) for your search service still apply.
6548

49+
## Run without reset
50+
51+
A [Run Indexer](/rest/api/searchservice/run-indexer) operation will detect and process only what it necessary to synchronize the search index with changes in the underlying data source. Incremental indexing starts by locating an internal high-water mark to find the last updated search document, which becomes the starting point for indexer execution over new and updated documents in the data source.
52+
53+
[Change detection](search-howto-create-indexers.md#change-detection-and-internal-state) is essential for determining what's new or updated in the data source. Indexers use the change detection capabilities of the underlying data source to determine what's new or updated in the data source.
54+
55+
+ Azure Storage has built-in change detection through its LastModified property.
56+
57+
+ Other data sources, such as Azure SQL or Azure Cosmos DB, have to be configured for change detection before the indexer can read new and updated rows.
58+
59+
If the underlying content is unchanged, a run operation has no effect. In this case, indexer execution history will indicate `0\0` documents processed.
60+
61+
You'll need to reset the indexer, as explained in the next section, to reprocess in full.
62+
6663
## Resetting indexers
6764

6865
After the initial run, an indexer keeps track of which search documents have been indexed through an internal *high-water mark*. The marker is never exposed, but internally the indexer knows where it last stopped.

0 commit comments

Comments
 (0)