Skip to content

Commit 79dbe9b

Browse files
committed
Freshness pass for May
1 parent 1fd55f9 commit 79dbe9b

9 files changed

+30
-29
lines changed

articles/search/index-add-custom-analyzers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.service: cognitive-search
99
ms.custom:
1010
- ignite-2023
1111
ms.topic: how-to
12-
ms.date: 11/28/2023
12+
ms.date: 05/23/2024
1313
---
1414

1515
# Add custom analyzers to string fields in an Azure AI Search index

articles/search/index-add-language-analyzers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.service: cognitive-search
99
ms.custom:
1010
- ignite-2023
1111
ms.topic: how-to
12-
ms.date: 07/19/2023
12+
ms.date: 05/23/2024
1313
---
1414

1515
# Add language analyzers to string fields in an Azure AI Search index

articles/search/search-analyzers.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: Analyzers for linguistic and text processing
33
titleSuffix: Azure AI Search
4-
description: Assign analyzers to searchable text fields in an index to replace default standard Lucene with custom, predefined or language-specific alternatives.
4+
description: Assign analyzers to searchable string fields in an index to replace default standard Lucene with custom, predefined or language-specific alternatives.
55
author: HeidiSteen
66
manager: nitinme
77
ms.author: heidist
88
ms.service: cognitive-search
99
ms.topic: conceptual
10-
ms.date: 07/19/2023
10+
ms.date: 05/23/2024
1111
ms.custom:
1212
- devx-track-csharp
1313
- ignite-2023
@@ -38,7 +38,11 @@ In Azure AI Search, an analyzer is automatically invoked on all string fields ma
3838

3939
By default, Azure AI Search uses the [Apache Lucene Standard analyzer (standard lucene)](https://lucene.apache.org/core/6_6_1/core/org/apache/lucene/analysis/standard/StandardAnalyzer.html), which breaks text into elements following the ["Unicode Text Segmentation"](https://unicode.org/reports/tr29/) rules. The standard analyzer converts all characters to their lower case form. Both indexed documents and search terms go through the analysis during indexing and query processing.
4040

41-
You can override the default on a field-by-field basis. Alternative analyzers can be a [language analyzer](index-add-language-analyzers.md) for linguistic processing, a [custom analyzer](index-add-custom-analyzers.md), or a built-in analyzer from the [list of available analyzers](index-add-custom-analyzers.md#built-in-analyzers).
41+
You can override the default on a field-by-field basis. Alternative analyzers are:
42+
43+
+ [language analyzer](index-add-language-analyzers.md) for linguistic processing
44+
+ [custom analyzer](index-add-custom-analyzers.md) for custom configurations
45+
+ [built-in analyzers](index-add-custom-analyzers.md#built-in-analyzers) for as-is usage
4246

4347
## Types of analyzers
4448

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

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.service: cognitive-search
1010
ms.custom:
1111
- ignite-2023
1212
ms.topic: how-to
13-
ms.date: 07/31/2023
13+
ms.date: 05/23/2024
1414
---
1515

1616
# How to index data from Azure SQL in Azure AI Search
@@ -49,7 +49,7 @@ The data source definition specifies the data to index, credentials, and policie
4949
1. [Create data source](/rest/api/searchservice/create-data-source) or [Update data source](/rest/api/searchservice/update-data-source) to set its definition:
5050

5151
```http
52-
POST https://myservice.search.windows.net/datasources?api-version=2020-06-30
52+
POST https://myservice.search.windows.net/datasources?api-version=2023-11-01
5353
Content-Type: application/json
5454
api-key: admin-key
5555
@@ -88,7 +88,7 @@ In a [search index](search-what-is-an-index.md), add fields that correspond to t
8888
1. [Create or update an index](/rest/api/searchservice/create-index) to define search fields that will store data:
8989

9090
```http
91-
POST https://[service name].search.windows.net/indexes?api-version=2020-06-30
91+
POST https://[service name].search.windows.net/indexes?api-version=2023-11-01
9292
Content-Type: application/json
9393
api-key: [Search service admin key]
9494
{
@@ -141,7 +141,7 @@ Once the index and data source have been created, you're ready to create the ind
141141
1. [Create or update an indexer](/rest/api/searchservice/create-indexer) by giving it a name and referencing the data source and target index:
142142
143143
```http
144-
POST https://[service name].search.windows.net/indexers?api-version=2020-06-30
144+
POST https://[service name].search.windows.net/indexers?api-version=2023-11-01
145145
Content-Type: application/json
146146
api-key: [search service admin key]
147147
{
@@ -170,7 +170,7 @@ Once the index and data source have been created, you're ready to create the ind
170170
171171
+ Default query timeout for SQL query execution is 5 minutes, which you can override.
172172
173-
+ "convertHighWaterMarkToRowVersion" optimizes for the [High Water Mark change detection policy](#HighWaterMarkPolicy). Change detection policies are set in the data source. If you're using the native change detection policy, this parameter has no effect.
173+
+ "convertHighWaterMarkToRowVersion" optimizes for the [High Water Mark Change Detection policy](#HighWaterMarkPolicy). Change detection policies are set in the data source. If you're using the native change detection policy, this parameter has no effect.
174174
175175
+ "disableOrderByHighWaterMarkColumn" causes the SQL query used by the [high water mark policy](#HighWaterMarkPolicy) to omit the ORDER BY clause. If you're using the native change detection policy, this parameter has no effect.
176176
@@ -185,7 +185,7 @@ An indexer runs automatically when it's created. You can prevent this by setting
185185
To monitor the indexer status and execution history, send a [Get Indexer Status](/rest/api/searchservice/get-indexer-status) request:
186186
187187
```http
188-
GET https://myservice.search.windows.net/indexers/myindexer/status?api-version=2020-06-30
188+
GET https://myservice.search.windows.net/indexers/myindexer/status?api-version=2023-11-01
189189
Content-Type: application/json
190190
api-key: [admin key]
191191
```
@@ -251,12 +251,12 @@ Database requirements:
251251
+ Tables only (no views)
252252
+ On the database, [enable change tracking](/sql/relational-databases/track-changes/enable-and-disable-change-tracking-sql-server) for the table
253253
+ No composite primary key (a primary key containing more than one column) on the table
254-
+ No clustered indexes on the table. As a workaround, any clustered index would have to be dropped and re-created as nonclustered index, however, performance may be affected in the source compared to having a clustered index
254+
+ No clustered indexes on the table. As a workaround, any clustered index would have to be dropped and re-created as nonclustered index, however, performance might be affected in the source compared to having a clustered index
255255

256256
Change detection policies are added to data source definitions. To use this policy, create or update your data source like this:
257257

258258
```http
259-
POST https://myservice.search.windows.net/datasources?api-version=2020-06-30
259+
POST https://myservice.search.windows.net/datasources?api-version=2023-11-01
260260
Content-Type: application/json
261261
api-key: admin-key
262262
{
@@ -293,7 +293,7 @@ The high water mark column must meet the following requirements:
293293
Change detection policies are added to data source definitions. To use this policy, create or update your data source like this:
294294

295295
```http
296-
POST https://myservice.search.windows.net/datasources?api-version=2020-06-30
296+
POST https://myservice.search.windows.net/datasources?api-version=2023-11-01
297297
Content-Type: application/json
298298
api-key: admin-key
299299
{
@@ -319,7 +319,7 @@ If you're using a [rowversion](/sql/t-sql/data-types/rowversion-transact-sql) da
319319

320320
+ Uses the rowversion data type for the high water mark column in the indexer SQL query. Using the correct data type improves indexer query performance.
321321

322-
+ Subtracts one from the rowversion value before the indexer query runs. Views with one-to-many joins may have rows with duplicate rowversion values. Subtracting one ensures the indexer query doesn't miss these rows.
322+
+ Subtracts one from the rowversion value before the indexer query runs. Views with one-to-many joins might have rows with duplicate rowversion values. Subtracting one ensures the indexer query doesn't miss these rows.
323323

324324
To enable this property, create or update the indexer with the following configuration:
325325

@@ -349,7 +349,7 @@ If you encounter timeout errors, set the `queryTimeout` indexer configuration se
349349

350350
##### disableOrderByHighWaterMarkColumn
351351

352-
You can also disable the `ORDER BY [High Water Mark Column]` clause. However, this isn't recommended because if the indexer execution is interrupted by an error, the indexer has to re-process all rows if it runs later, even if the indexer has already processed almost all the rows at the time it was interrupted. To disable the `ORDER BY` clause, use the `disableOrderByHighWaterMarkColumn` setting in the indexer definition:
352+
You can also disable the `ORDER BY [High Water Mark Column]` clause. However, this isn't recommended because if the indexer execution is interrupted by an error, the indexer has to reprocess all rows if it runs later, even if the indexer has already processed almost all the rows at the time it was interrupted. To disable the `ORDER BY` clause, use the `disableOrderByHighWaterMarkColumn` setting in the indexer definition:
353353

354354
```http
355355
{
@@ -363,7 +363,7 @@ You can also disable the `ORDER BY [High Water Mark Column]` clause. However, th
363363

364364
When rows are deleted from the source table, you probably want to delete those rows from the search index as well. If you use the SQL integrated change tracking policy, this is taken care of for you. However, the high water mark change tracking policy doesn’t help you with deleted rows. What to do?
365365

366-
If the rows are physically removed from the table, Azure AI Search has no way to infer the presence of records that no longer exist. However, you can use the “soft-delete” technique to logically delete rows without removing them from the table. Add a column to your table or view and mark rows as deleted using that column.
366+
If the rows are physically removed from the table, Azure AI Search has no way to infer the presence of records that no longer exist. However, you can use the “soft-delete” technique to logically delete rows without removing them from the table. Add a column to your table or view and mark rows as deleted using that column.
367367

368368
When using the soft-delete technique, you can specify the soft delete policy as follows when creating or updating the data source:
369369

@@ -386,7 +386,7 @@ If you're setting up a soft delete policy from the Azure portal, don't add quote
386386

387387
**Q: Can I index Always Encrypted columns?**
388388

389-
No. [Always Encrypted](/sql/relational-databases/security/encryption/always-encrypted-database-engine) columns aren't currently supported by Azure AI Search indexers.
389+
No, [Always Encrypted](/sql/relational-databases/security/encryption/always-encrypted-database-engine) columns aren't currently supported by Azure AI Search indexers.
390390

391391
**Q: Can I use Azure SQL indexer with SQL databases running on IaaS VMs in Azure?**
392392

@@ -412,7 +412,7 @@ If you attempt to use rowversion on a read-only replica, you'll see the followin
412412

413413
**Q: Can I use an alternative, non-rowversion column for high water mark change tracking?**
414414

415-
It's not recommended. Only **rowversion** allows for reliable data synchronization. However, depending on your application logic, it may be safe if:
415+
It's not recommended. Only **rowversion** allows for reliable data synchronization. However, depending on your application logic, it can be safe if:
416416

417417
+ You can ensure that when the indexer runs, there are no outstanding transactions on the table that’s being indexed (for example, all table updates happen as a batch on a schedule, and the Azure AI Search indexer schedule is set to avoid overlapping with the table update schedule).
418418

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.service: cognitive-search
1010
ms.custom:
1111
- ignite-2023
1212
ms.topic: how-to
13-
ms.date: 07/31/2023
13+
ms.date: 05/23/2024
1414
---
1515

1616
# Indexer connections to Azure SQL Managed Instance through a public endpoint

articles/search/search-traffic-analytics.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,7 @@ ms.author: heidist
88

99
ms.service: cognitive-search
1010
ms.topic: conceptual
11-
ms.date: 05/26/2023
12-
ms.custom:
13-
- devx-track-csharp
14-
- ignite-2023
11+
ms.date: 05/23/2024
1512
---
1613

1714
# Collect telemetry data for search traffic analytics
@@ -80,7 +77,7 @@ var telemetryClient = new TelemetryClient();
8077
telemetryClient.InstrumentationKey = "0000000000000000000000000000";
8178
```
8279

83-
<!-- ### Request a Search ID for correlation
80+
### Request a Search ID for correlation
8481

8582
> [!IMPORTANT]
8683
> In the Azure portal, the snippets for request headers are made using an outdated version of the Azure SDK. Updates are pending.
@@ -98,7 +95,7 @@ string searchId = string.Empty;
9895
if (response.Response.Headers.TryGetValues("x-ms-azs-searchid", out headerValues)){
9996
searchId = headerValues.FirstOrDefault();
10097
}
101-
```-->
98+
```
10299

103100
### Log search events
104101

articles/search/tutorial-python-create-load-index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: diberry
77
ms.author: diberry
88
ms.service: cognitive-search
99
ms.topic: tutorial
10-
ms.date: 07/18/2023
10+
ms.date: 04/25/2024
1111
ms.custom:
1212
- devx-track-python
1313
- devx-track-azurecli

articles/search/tutorial-python-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: diberry
77
ms.author: diberry
88
ms.service: cognitive-search
99
ms.topic: tutorial
10-
ms.date: 07/18/2023
10+
ms.date: 04/25/2024
1111
ms.custom:
1212
- devx-track-python
1313
- ignite-2023

articles/search/tutorial-python-search-query-integration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: diberry
77
ms.author: diberry
88
ms.service: cognitive-search
99
ms.topic: tutorial
10-
ms.date: 09/21/2023
10+
ms.date: 04/25/2024
1111
ms.custom:
1212
- devx-track-python
1313
- ignite-2023

0 commit comments

Comments
 (0)