Skip to content

Commit cad6c63

Browse files
committed
Simplified prereq and change tracking
1 parent b5c6f9f commit cad6c63

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

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

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ This article supplements [**Create an indexer**](search-howto-create-indexers.md
1919

2020
## Prerequisites
2121

22-
+ An [Azure SQL database](../azure-sql/database/sql-database-paas-overview.md) with data in a single table or view. Use a table if you want the ability to [update a search index with new and updated rows](#CaptureChangedRows) using SQL's native change detection capabilities.
22+
+ An [Azure SQL database](../azure-sql/database/sql-database-paas-overview.md) with data in a single table or view. Use a table if you want the ability to [index data updates](#CaptureChangedRows) using SQL's native change detection capabilities.
2323

24-
+ Read permissions. Azure Cognitive Search supports SQL Server authentication, where the username and password are provided on the connection string. Alternatively, you can set up a managed identity and use Azure roles to omit credentials on the connection. For more information, see [Set up an indexer connection using a managed identity](search-howto-managed-identities-sql.md).
24+
+ Read permissions. Azure Cognitive Search supports SQL Server authentication, where the user name and password are provided on the connection string. Alternatively, you can [set up a managed identity and use Azure roles](search-howto-managed-identities-sql.md) to omit credentials on the connection.
2525

2626
<!-- Real-time data synchronization must not be an application requirement. An indexer can reindex your table at most every five minutes. If your data changes frequently, and those changes need to be reflected in the index within seconds or single minutes, we recommend using the [REST API](/rest/api/searchservice/AddUpdate-or-Delete-Documents) or [.NET SDK](search-get-started-dotnet.md) to push updated rows directly.
2727
@@ -146,13 +146,19 @@ For more information about defining indexer schedules see [How to schedule index
146146

147147
<a name="CaptureChangedRows"></a>
148148

149-
## Capture new, changed, and deleted rows
149+
## Indexing new, changed, and deleted rows
150150

151-
Azure Cognitive Search uses **incremental indexing** to avoid having to reindex the entire table or view every time an indexer runs. Azure Cognitive Search provides two change detection policies to support incremental indexing.
151+
If your SQL database supports [change tracking](/sql/relational-databases/track-changes/about-change-tracking-sql-server), a search indexer can pick up just the new and updated content on subsequent indexer runs. Azure Cognitive Search provides two change detection policies to support incremental indexing.
152+
153+
Within an indexer definition, you can specify a change detection policies that tells the indexer which change tracking mechanism is used on your table or view. There are two policies to choose from:
154+
155+
+ "SqlIntegratedChangeTrackingPolicy" (applies to tables only)
156+
157+
+ "HighWaterMarkChangeDetectionPolicy" (works for tables and views)
152158

153159
### SQL Integrated Change Tracking Policy
154160

155-
If your SQL database supports [change tracking](/sql/relational-databases/track-changes/about-change-tracking-sql-server), we recommend using **SQL Integrated Change Tracking Policy**. This is the most efficient policy. In addition, it allows Azure Cognitive Search to identify deleted rows without you having to add an explicit "soft delete" column to your table.
161+
We recommend using **SQL Integrated Change Tracking Policy** for its efficiency and its ability to identify deleted rows.
156162

157163
#### Requirements
158164

0 commit comments

Comments
 (0)