Skip to content

Commit 7ad983f

Browse files
committed
Added ToC entry for How to schedule indexers article. Also linked to the article from the four tech-specific indexer articles.
1 parent 80de480 commit 7ad983f

6 files changed

+22
-35
lines changed

articles/search/TOC.yml

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -163,24 +163,26 @@
163163
items:
164164
- name: Indexers overview
165165
href: search-indexer-overview.md
166-
- name: Blob storage indexer
167-
href: search-howto-indexing-azure-blob-storage.md
168-
- name: Table storage indexer
166+
- name: Azure Table Storage indexer
169167
href: search-howto-indexing-azure-tables.md
170-
- name: SQL DB indexer
168+
- name: Azure SQL DB indexer
171169
href: search-howto-connecting-azure-sql-database-to-azure-search-using-indexers.md
172-
- name: Cosmos DB indexer
170+
- name: Azure Cosmos DB indexer
173171
href: search-howto-index-cosmosdb.md
174-
- name: One-to-many blob indexing
175-
href: search-howto-index-one-to-many-blobs.md
176-
- name: CSV blob indexing
177-
href: search-howto-index-csv-blobs.md
178-
- name: JSON blob indexing
179-
href: search-howto-index-json-blobs.md
180-
- name: Connect to SQL Server VMs
181-
href: search-howto-connecting-azure-sql-iaas-to-azure-search-using-indexers.md
172+
- name: Azure Blob Storage indexer
173+
items:
174+
- name: Set up a Blob Storage indexer
175+
href: search-howto-indexing-azure-blob-storage.md
176+
- name: Index one-to-many blobs
177+
href: search-howto-index-one-to-many-blobs.md
178+
- name: Index CSV blobs
179+
href: search-howto-index-csv-blobs.md
180+
- name: Index JSON blobs
181+
href: search-howto-index-json-blobs.md
182182
- name: Field mappings
183183
href: search-indexer-field-mappings.md
184+
- name: Connect to SQL Server VMs
185+
href: search-howto-connecting-azure-sql-iaas-to-azure-search-using-indexers.md
184186
- name: Troubleshooting common issues
185187
href: search-indexer-troubleshooting.md
186188
- name: Enrich with AI

articles/search/search-howto-connecting-azure-sql-database-to-azure-search-using-indexers.md

Lines changed: 1 addition & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -154,23 +154,7 @@ You can also arrange the indexer to run periodically on a schedule. To do this,
154154
155155
The **interval** parameter is required. The interval refers to the time between the start of two consecutive indexer executions. The smallest allowed interval is 5 minutes; the longest is one day. It must be formatted as an XSD "dayTimeDuration" value (a restricted subset of an [ISO 8601 duration](https://www.w3.org/TR/xmlschema11-2/#dayTimeDuration) value). The pattern for this is: `P(nD)(T(nH)(nM))`. Examples: `PT15M` for every 15 minutes, `PT2H` for every 2 hours.
156156
157-
The optional **startTime** indicates when the scheduled executions should commence. If it is omitted, the current UTC time is used. This time can be in the past – in which case the first execution is scheduled as if the indexer has been running continuously since the startTime.
158-
159-
Only one execution of an indexer can run at a time. If an indexer is running when its execution is scheduled, the execution is postponed until the next scheduled time.
160-
161-
Let’s consider an example to make this more concrete. Suppose we the following hourly schedule configured:
162-
163-
"schedule" : { "interval" : "PT1H", "startTime" : "2015-03-01T00:00:00Z" }
164-
165-
Here’s what happens:
166-
167-
1. The first indexer execution starts at or around March 1, 2015 12:00 a.m. UTC.
168-
2. Assume this execution takes 20 minutes (or any time less than 1 hour).
169-
3. The second execution starts at or around March 1, 2015 1:00 a.m.
170-
4. Now suppose that this execution takes more than an hour – for example, 70 minutes – so that it completes around 2:10 a.m.
171-
5. It’s now 2:00 a.m., time for the third execution to start. However, because the second execution from 1 a.m. is still running, the third execution is skipped. The third execution starts at 3 a.m.
172-
173-
You can add, change, or delete a schedule for an existing indexer by using a **PUT indexer** request.
157+
For more information about defining indexer schedules see [How to schedule indexers for Azure Search](https://docs.microsoft.com/en-us/azure/search/search-howto-schedule-indexer).
174158
175159
<a name="CaptureChangedRows"></a>
176160

articles/search/search-howto-index-cosmosdb.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -279,6 +279,8 @@ This indexer runs every two hours (schedule interval is set to "PT2H"). To run a
279279

280280
For more details on the Create Indexer API, check out [Create Indexer](https://docs.microsoft.com/rest/api/searchservice/create-indexer).
281281

282+
For more information about defining indexer schedules see [How to schedule indexers for Azure Search](https://docs.microsoft.com/en-us/azure/search/search-howto-schedule-indexer).
283+
282284
## Use .NET
283285

284286
The generally available .NET SDK has full parity with the generally available REST API. We recommend that you review the previous REST API section to learn concepts, workflow, and requirements. You can then refer to following .NET API reference documentation to implement a JSON indexer in managed code.

articles/search/search-howto-indexing-azure-blob-storage.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,8 @@ This indexer will run every two hours (schedule interval is set to "PT2H"). To r
116116

117117
For more details on the Create Indexer API, check out [Create Indexer](https://docs.microsoft.com/rest/api/searchservice/create-indexer).
118118

119+
For more information about defining indexer schedules see [How to schedule indexers for Azure Search](https://docs.microsoft.com/en-us/azure/search/search-howto-schedule-indexer).
120+
119121
## How Azure Search indexes blobs
120122

121123
Depending on the [indexer configuration](#PartsOfBlobToIndex), the blob indexer can index storage metadata only (useful when you only care about the metadata and don't need to index the content of blobs), storage and content metadata, or both metadata and textual content. By default, the indexer extracts both metadata and content.
@@ -139,7 +141,6 @@ Depending on the [indexer configuration](#PartsOfBlobToIndex), the blob indexer
139141
* **metadata\_storage\_last\_modified** (Edm.DateTimeOffset) - last modified timestamp for the blob. Azure Search uses this timestamp to identify changed blobs, to avoid reindexing everything after the initial indexing.
140142
* **metadata\_storage\_size** (Edm.Int64) - blob size in bytes.
141143
* **metadata\_storage\_content\_md5** (Edm.String) - MD5 hash of the blob content, if available.
142-
* **metadata\_storage\_sas\_token** (Edm.String) - A temporary token that can be used by [custom skills](cognitive-search-custom-skill-interface.md) to get right access to the blob. This sas token is not supposed to be stored for later use as it may expire.
143144
* Metadata properties specific to each document format are extracted into the fields listed [here](#ContentSpecificMetadata).
144145

145146
You don't need to define fields for all of the above properties in your search index - just capture the properties you need for your application.

articles/search/search-howto-indexing-azure-tables.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,8 @@ This indexer runs every two hours. (The schedule interval is set to "PT2H".) To
111111

112112
For more information on the Create Indexer API, see [Create Indexer](https://docs.microsoft.com/rest/api/searchservice/create-indexer).
113113

114+
For more information about defining indexer schedules see [How to schedule indexers for Azure Search](search-howto-schedule-indexer.md).
115+
114116
## Deal with different field names
115117
Sometimes, the field names in your existing index are different from the property names in your table. You can use field mappings to map the property names from the table to the field names in your search index. To learn more about field mappings, see [Azure Search indexer field mappings bridge the differences between datasources and search indexes](search-indexer-field-mappings.md).
116118

articles/search/search-howto-schedule-indexers.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,3 @@ The .NET SDK lets you control indexer operations using the [SearchServiceClient]
109109
You can run an indexer on demand at any time using one of the [Run](https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.search.indexersoperationsextensions.run), [RunAsync](https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.search.indexersoperationsextensions.runasync), or [RunWithHttpMessagesAsync](https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.search.iindexersoperations.runwithhttpmessagesasync) methods.
110110

111111
For more information about creating, updating, and running indexers, see [IIindexersOperations](https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.search.iindexersoperations?view=azure-dotnet).
112-
113-
114-
## Help us make Azure Search better
115-
If you have feature requests or ideas for improvements, please reach out to us on our [UserVoice site](https://feedback.azure.com/forums/263029-azure-search/).

0 commit comments

Comments
 (0)