Skip to content

Commit 72d544d

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
authored andcommitted
Merging changes synced from https://github.com/MicrosoftDocs/azure-ai-docs-pr (branch live)
2 parents a24e358 + e1e8e23 commit 72d544d

8 files changed

+31
-20
lines changed

articles/search/search-blob-indexer-role-based-access.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -168,9 +168,10 @@ JSON schema example:
168168

169169
To effectively manage blob deletion, ensure that you have enabled [deletion tracking](search-howto-index-changed-deleted-blobs.md) before your indexer runs for the first time. This feature allows the system to detect deleted blobs from your source and have them deleted from the index.
170170

171-
## Related content
171+
## See also
172172

173+
+ [Connect to Azure AI Search using roles](search-security-rbac.md)
174+
- [Query-Time ACL and RBAC enforcement](search-query-access-control-rbac-enforcement.md)
175+
- [azure-search-python-samples/Quickstart-Document-Permissions-Push-API](https://github.com/Azure-Samples/azure-search-python-samples/blob/main/Quickstart-Document-Permissions-Push-API)
173176
+ [Search over Azure Blob Storage content](search-blob-storage-integration.md)
174177
+ [Configure a blob indexer](search-howto-indexing-azure-blob-storage.md)
175-
+ [Change and delete detection using indexers for Azure Storage](search-howto-index-changed-deleted-blobs.md)
176-
+ [Connect to Azure AI Search using roles](search-security-rbac.md)

articles/search/search-index-access-control-lists-and-rbac-push-api.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,8 @@ This example illustrates how the document access rules are resolved based on the
122122
| 6 | ["user1", "user2"] | ["group1"] | Empty | User1, user2, or any member of group1 | |
123123
| 7 | ["user1", "user2"] | [] | Empty | User1, user2, or any user with RBAC permissions to container1 | |
124124

125-
## Next steps
125+
## See also
126126

127+
- [Connect to Azure AI Search using roles](search-security-rbac.md)
127128
- [Query-Time ACL and RBAC enforcement](search-query-access-control-rbac-enforcement.md)
128129
- [azure-search-python-samples/Quickstart-Document-Permissions-Push-API](https://github.com/Azure-Samples/azure-search-python-samples/blob/main/Quickstart-Document-Permissions-Push-API)

articles/search/search-indexer-access-control-lists-and-role-based-access.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -298,3 +298,8 @@ Choose one of the following mechanisms, depending on how many items changed:
298298

299299
To effectively manage blob deletion, ensure that you have enabled [deletion tracking](search-howto-index-changed-deleted-blobs.md) before your indexer runs for the first time. This feature allows the system to detect deleted blobs from your source and have them deleted from the index.
300300

301+
## See also
302+
303+
+ [Connect to Azure AI Search using roles](search-security-rbac.md)
304+
+ [Query-Time ACL and RBAC enforcement](search-query-access-control-rbac-enforcement.md)
305+
+ [azure-search-python-samples/Quickstart-Document-Permissions-Push-API](https://github.com/Azure-Samples/azure-search-python-samples/blob/main/Quickstart-Document-Permissions-Push-API)

articles/search/search-query-access-control-rbac-enforcement.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ Content-Type: application/json
7676
}
7777
```
7878

79-
## Related content
79+
## See also
8080

8181
- [Tutorial: Index ADLS Gen2 permission metadata](tutorial-adls-gen2-indexer-acls.md)
8282

articles/search/search-relevance-overview.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,10 +17,12 @@ In a query operation, the relevance of any given result is measured by a ranking
1717

1818
Ranking occurs whenever the query request includes full text or vector queries. It doesn't occur if the query invokes strict pattern matching, such as a filter-only query or a specialized query form like autocomplete, suggestions, geospatial search, fuzzy search, or regular expression search. A uniform search score of 1.0 indicates the absence of a ranking algorithm.
1919

20-
The query engine in Azure AI Search supports a multi-level approach to ranking search results, where there's a built-in ranking modality for each query type, plus extra ranking capabilities for extended relevance tuning.
20+
***Relevance tuning*** is primarily directed at textual content, applying scoring profiles or semantic ranking to enhance the quality of search results. For vector content, there's no explicit relevance tuning capabilities, but you can experiment between Hierarchical Navigable Small World (HNSW) and exhaustive K-nearest neighbors (KNN) to see if one algorithm outperforms the other for your scenario. HNSW graphing with an exhaustive KNN override at query time is the most flexible approach for comparison testing. You can also experiment with various embedding models to see which ones produce higher quality results.
2121

2222
## Levels of ranking
2323

24+
The query engine in Azure AI Search supports a multi-level approach to ranking search results, where there's a built-in ranking modality for each query type, plus extra ranking capabilities for extended relevance tuning.
25+
2426
This section describes the levels of scoring operations. For an illustration of how they work together, see the [diagram](#diagram-of-ranking-algorithms) in this article. A [comparison of all search score types and ranges](#types-of-search-scores) is also provided in this article.
2527

2628
| Level | Description |

articles/search/search-security-overview.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.update-cycle: 180-days
1111
ms.custom:
1212
- ignite-2023
1313
ms.topic: conceptual
14-
ms.date: 02/28/2025
14+
ms.date: 07/26/2025
1515
---
1616

1717
# Security in Azure AI Search
@@ -155,9 +155,11 @@ For multitenancy solutions requiring security boundaries at the index level, it'
155155

156156
### Restricting access to documents
157157

158-
User permissions at the document level, also known as *row-level security*, isn't natively supported in Azure AI Search. If you import data from an external system that provides row-level security, such as Azure Cosmos DB, those permissions won't transfer with the data as its being indexed by Azure AI Search.
158+
User permissions at the document level, also known as *row-level security*, is available as a preview feature and depends on the data source. If content originates from [Azure Data Lake Storage (ADLS) Gen2](search-indexer-access-control-lists-and-role-based-access.md) or [Azure blobs](search-blob-indexer-role-based-access.md), user permission metadata that originates in Azure Storage is preserved in indexer-generated indexes and enforced at query time so that only authorized content is included in search results.
159159

160-
If you require permissioned access over content in search results, there's a technique for applying filters that include or exclude documents based on user identity. This workaround adds a string field in the data source that represents a group or user identity, which you can make filterable in your index. For more information about this pattern, see [Security trimming based on identity filters](search-security-trimming-for-azure-search.md).
160+
For other data sources, you can [push a document payload that includes user or group permission metadata](search-index-access-control-lists-and-rbac-push-api.md), and those permissions are retained in indexed content and also enforced at query time. This capability is also in preview.
161+
162+
If you can't use preview features and you require permissioned access over content in search results, there's a technique for applying filters that include or exclude documents based on user identity. This workaround adds a string field in the data source that represents a group or user identity, which you can make filterable in your index. For more information about this pattern, see [Security trimming based on identity filters](search-security-trimming-for-azure-search.md). For more information about document access, see [Document-level access control](search-document-level-access-overview.md).
161163

162164
## Data residency
163165

articles/search/search-what-is-an-index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ ms.date: 06/20/2025
1616

1717
# Search indexes in Azure AI Search
1818

19-
In Azure AI Search, a *search index* is your searchable content, available to the search engine for indexing, full-text search, vector search, hybrid search, and filtered queries. An index is defined by a schema and saved to the search service, with data import following as a second step. This content exists within your search service, apart from your primary data stores, which is necessary for the millisecond response times expected in modern search applications. Except for indexer-driven indexing scenarios, the search service never connects to or queries your source data.
19+
In Azure AI Search, a *search index* is your searchable content, available to the search engine for indexing, agentic search, full-text search, vector search, hybrid search, and filtered queries. An index is defined by a schema and saved to the search service, with data ingestion following as a second step. Indexed content exists within your search service, apart from your primary external data stores, which is necessary for the millisecond response times expected in modern search applications. Except for indexer-driven indexing scenarios, the search service never connects to or queries your external source data.
2020

2121
This article covers the key concepts for creating and managing a search index, including:
2222

articles/search/toc.yml

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -18,28 +18,22 @@ items:
1818
items:
1919
- name: Data
2020
items:
21+
- name: Data import strategies
22+
href: search-what-is-data-import.md
2123
- name: Search index
2224
href: search-what-is-an-index.md
2325
- name: Vector index
2426
href: vector-store.md
2527
- name: Knowledge store
2628
href: knowledge-store-concept-intro.md
27-
- name: Data import strategies
28-
href: search-what-is-data-import.md
2929
- name: Indexers
3030
href: search-indexer-overview.md
3131
- name: Applied AI
3232
items:
33-
- name: Multimodal search
34-
href: multimodal-search-overview.md
35-
- name: Built-in vectorization
36-
href: vector-search-integrated-vectorization.md
3733
- name: AI enrichment during indexing
3834
href: cognitive-search-concept-intro.md
39-
- name: Enrichment cache
40-
href: cognitive-search-incremental-indexing-conceptual.md
41-
- name: Skillsets
42-
href: cognitive-search-working-with-skillsets.md
35+
- name: Built-in vectorization
36+
href: vector-search-integrated-vectorization.md
4337
- name: Retrieval
4438
items:
4539
- name: Agentic search
@@ -50,6 +44,8 @@ items:
5044
href: vector-search-overview.md
5145
- name: Hybrid search
5246
href: hybrid-search-overview.md
47+
- name: Multimodal search
48+
href: multimodal-search-overview.md
5349
- name: Retrieval Augmented Generation (RAG)
5450
href: retrieval-augmented-generation-overview.md
5551
- name: Other query types
@@ -348,6 +344,8 @@ items:
348344
href: search-howto-index-sharepoint-online.md
349345
- name: Skillsets (indexers)
350346
items:
347+
- name: Skillsets overview
348+
href: cognitive-search-working-with-skillsets.md
351349
- name: Create a skillset
352350
href: cognitive-search-defining-skillset.md
353351
- name: Attach an Azure AI resource
@@ -364,6 +362,8 @@ items:
364362
href: cognitive-search-output-field-mapping.md
365363
- name: Process image files
366364
href: cognitive-search-concept-image-scenarios.md
365+
- name: Enrichment cache
366+
href: cognitive-search-incremental-indexing-conceptual.md
367367
- name: Cache (incremental) enrichment
368368
href: search-howto-incremental-index.md
369369
- name: Design tips

0 commit comments

Comments
 (0)