View Diff on GitHub
# Highlights
このドキュメントの変更における主なハイライトは、日付やトピックの種類、および特定のコンテンツの明確化に関するマイナーな更新が行われたことです。特に、Azure AI Searchに関する複数のファイルでは、近年の技術トレンドを反映した日付の更新が主要な焦点となっています。また、一部の文書ではより良い分類のためにトピックの種類の変更や、コンテンツの詳細や明確化が行われました。
New features
Breaking changes
Other updates
- すべての日付「ms.date」が2024年12月10日に更新されました。これにより、ドキュメントが最新の情報を反映していることをユーザーに示しています。
- 一部の文書では、トピックの種類が「reference」に変更され、より正確なリファレンス情報を提供するように調整されました。
- 検索結果の構成に関する内容やセマンティックランカーの制限に関する情報が更新され、理解しやすくなっています。
Insights
Azure AI Searchに関するドキュメントの一連の更新は、大幅に内容を変更することなく、日付の更新といくつかのコンテンツの明確化を通じて文書の信頼性と正確性を維持しようとしています。技術ドキュメントにおいて、最新の情報を反映することは信頼性の高い情報を提供するために重要であり、読者は常に現行のベストプラクティスや機能を活用できることが期待されます。
特に、Azure AI Searchの各種機能や使用ケースに正しくアクセスできるようにするためのコンテンツの明確化が行われたという点で、この更新は利用者に非常に有益です。Azure AI Searchのパフォーマンスを最適化するための情報や、サービスを管理するためのガイドラインが常に最新の状態に保たれているため、エンドユーザーはより効率的にサービスを活用することができます。
また、一部の文書ではより適切なカテゴリ付けが行われ、ユーザーが必要とする情報に迅速にアクセスできるようになっており、全体のユーザーエクスペリエンスが向上しています。これにより、ユーザーは情報検索や実装に際して困難を感じることなく、Azure AI Searchの機能を最大限に利用することができます。
Summary Table
Modified Contents
articles/search/cognitive-search-concept-annotations-syntax.md
Diff
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 01/18/2024
+ms.date: 12/10/2024
---
# Reference a path to enriched nodes using context and source properties an Azure AI Search skillset
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、cognitive-search-concept-annotations-syntax.md
ファイル内の日付を更新するもので、具体的には「ms.date」の値が2024年1月18日から2024年12月10日に変更されました。この修正は、ドキュメントの正確性を保つための軽微な更新です。元の行は「-ms.date: 01/18/2024」であり、新しい行は「+ms.date: 12/10/2024」です。この変更により、内容の信頼性が向上し、利用者がより適切な情報を得ることができるようになります。
articles/search/cognitive-search-concept-troubleshooting.md
Diff
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 02/16/2024
+ms.date: 12/10/2024
---
# Tips for AI enrichment in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、cognitive-search-concept-troubleshooting.md
ファイルの日付を更新するもので、具体的には「ms.date」の値が2024年2月16日から2024年12月10日に変更されました。この修正は、ドキュメントの正確性と関連性を維持するためのものであり、情報を利用するユーザーにとって、より最新の情報を提供することを目的としています。元のラインは「-ms.date: 02/16/2024」であり、新しいラインは「+ms.date: 12/10/2024」です。これにより、ユーザーは最新の状況に基づいた情報を得ることができます。
articles/search/index-similarity-and-scoring.md
Diff
@@ -9,12 +9,12 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 05/06/2024
+ms.date: 12/10/2024
---
# Relevance in keyword search (BM25 scoring)
-This article explains the BM25 relevance scoring algorithm used to compute search scores for [full text search](search-lucene-query-architecture.md). BM25 relevance is exclusive to full text search. Filter queries, autocomplete and suggested queries, wildcard search or fuzzy search queries aren't scored or ranked for relevance.
+This article explains the BM25 relevance scoring algorithm used to compute search scores for [full text search](search-lucene-query-architecture.md). BM25 relevance is exclusive to full text search. Filter queries, autocomplete and suggested queries, wildcard search, and fuzzy search queries aren't scored or ranked for relevance.
## Scoring algorithms used in full text search
@@ -23,39 +23,36 @@ Azure AI Search provides the following scoring algorithms for full text search:
| Algorithm | Usage | Range |
|-----------|-------------|-------|
| `BM25Similarity` | Fixed algorithm on all search services created after July 2020. You can configure this algorithm, but you can't switch to an older one (classic). | Unbounded. |
-|`ClassicSimilarity` | Present on older search services. You can [opt-in for BM25](index-ranking-similarity.md) and choose an algorithm on a per-index basis. | 0 < 1.00 |
+|`ClassicSimilarity` | Default on older search services that predate July 2020. On older services, you can [opt-in for BM25](index-ranking-similarity.md#enable-bm25-scoring-on-older-services) and choose a the BM25 algorithm on a per-index basis. | 0 < 1.00 |
-Both BM25 and Classic are TF-IDF-like retrieval functions that use the term frequency (TF) and the inverse document frequency (IDF) as variables to calculate relevance scores for each document-query pair, which is then used for ranking results. While conceptually similar to classic, BM25 is rooted in probabilistic information retrieval that produces more intuitive matches, as measured by user research.
+Both BM25 and Classic are TF-IDF-like retrieval functions that use the term frequency (TF) and the inverse document frequency (IDF) as variables to calculate relevance scores for each document-query pair, which is then used for ranking results. While conceptually similar to classic, BM25 is rooted in probabilistic information retrieval that produces more intuitive matches, as measured by user research.
-BM25 offers advanced customization options, such as allowing the user to decide how the relevance score scales with the term frequency of matched terms. For more information, see [Configure the scoring algorithm](index-ranking-similarity.md).
-
-> [!NOTE]
-> If you're using a search service that was created before July 2020, the scoring algorithm is most likely the previous default, `ClassicSimilarity`, which you can upgrade on a per-index basis. See [Enable BM25 scoring on older services](index-ranking-similarity.md#enable-bm25-scoring-on-older-services) for details.
-
-The following video segment fast-forwards to an explanation of the generally available ranking algorithms used in Azure AI Search. You can watch the full video for more background.
-
-> [!VIDEO https://www.youtube.com/embed/Y_X6USgvB1g?version=3&start=322&end=643]
+BM25 offers [advanced customization options](index-ranking-similarity.md), such as allowing the user to decide how the relevance score scales with the term frequency of matched terms.
## How BM25 ranking works
-Relevance scoring refers to the computation of a search score (**@search.score**) that serves as an indicator of an item's relevance in the context of the current query. The range is unbounded. However, the higher the score, the more relevant the item.
+Relevance scoring refers to the computation of a search score (**@search.score**) that serves as an indicator of an item's relevance in the context of the current query. The range is unbounded. However, the higher the score, the more relevant the item.
The search score is computed based on statistical properties of the string input and the query itself. Azure AI Search finds documents that match on search terms (some or all, depending on [searchMode](/rest/api/searchservice/documents/search-post#searchrequest)), favoring documents that contain many instances of the search term. The search score goes up even higher if the term is rare across the data index, but common within the document. The basis for this approach to computing relevance is known as *TF-IDF or* term frequency-inverse document frequency.
Search scores can be repeated throughout a result set. When multiple hits have the same search score, the ordering of the same scored items is undefined and not stable. Run the query again, and you might see items shift position, especially if you're using the free service or a billable service with multiple replicas. Given two items with an identical score, there's no guarantee that one appears first.
-To break the tie among repeating scores, you can add an **$orderby** clause to first order by score, then order by another sortable field (for example, `$orderby=search.score() desc,Rating desc`). For more information, see [$orderby](search-query-odata-orderby.md).
+To break the tie among repeating scores, you can add an [**$orderby** clause](search-query-odata-orderby.md) to first order by score, then order by another sortable field (for example, `$orderby=search.score() desc,Rating desc`).
Only fields marked as `searchable` in the index, or `searchFields` in the query, are used for scoring. Only fields marked as `retrievable`, or fields specified in `select` in the query, are returned in search results, along with their search score.
> [!NOTE]
> A `@search.score = 1` indicates an un-scored or un-ranked result set. The score is uniform across all results. Un-scored results occur when the query form is fuzzy search, wildcard or regex queries, or an empty search (`search=*`, sometimes paired with filters, where the filter is the primary means for returning a match).
+The following video segment fast-forwards to an explanation of the generally available ranking algorithms used in Azure AI Search. You can watch the full video for more background.
+
+> [!VIDEO https://www.youtube.com/embed/Y_X6USgvB1g?version=3&start=322&end=643]
+
## Scores in a text results
-Whenever results are ranked, **`@search.score`** property contains the value used to order the results.
+Whenever results are ranked, **`@search.score`** property contains the value used to order the results.
-The following table identifies the scoring property returned on each match, algorithm, and range.
+The following table identifies the scoring property, algorithm, and range.
| Search method | Parameter | Scoring algorithm | Range |
|---------------|-----------|-------------------|-------|
@@ -91,7 +88,7 @@ The diagram above is only one example. Many combinations of partitions and repli
<a name="scoring-statistics"></a>
-### Scoring statistics and sticky sessions
+## Scoring statistics and sticky sessions
For scalability, Azure AI Search distributes each index horizontally through a sharding process, which means that [portions of an index are physically separate](#sharding-effects-on-query-results).
@@ -107,7 +104,7 @@ POST https://[service name].search.windows.net/indexes/hotels/docs/search?api-ve
}
```
-Using `scoringStatistics` will ensure that all shards in the same replica provide the same results. That said, different replicas may be slightly different from one another as they're always getting updated with the latest changes to your index. In some scenarios, you may want your users to get more consistent results during a "query session". In such scenarios, you can provide a `sessionId` as part of your queries. The `sessionId` is a unique string that you create to refer to a unique user session.
+Using `scoringStatistics` will ensure that all shards in the same replica provide the same results. That said, different replicas can be slightly different from one another as they're always getting updated with the latest changes to your index. In some scenarios, you might want your users to get more consistent results during a "query session". In such scenarios, you can provide a `sessionId` as part of your queries. The `sessionId` is a unique string that you create to refer to a unique user session.
```http
POST https://[service name].search.windows.net/indexes/hotels/docs/search?api-version=2024-07-01
@@ -124,12 +121,12 @@ As long as the same `sessionId` is used, a best-effort attempt is made to target
## Relevance tuning
-In Azure AI Search, you can configure BM25 algorithm parameters, and tune search relevance and boost search scores through these mechanisms:
+In Azure AI Search, for keyword search and the text portion of a hybrid query, you can configure BM25 algorithm parameters plus tune search relevance and boost search scores through the following mechanisms.
| Approach | Implementation | Description |
|----------|----------------|-------------|
-| [Scoring algorithm configuration](index-ranking-similarity.md) | Search index | |
-| [Scoring profiles](index-add-scoring-profiles.md) | Search index | Provide criteria for boosting the search score of a match based on content characteristics. For example, you might want to boost matches based on their revenue potential, promote newer items, or perhaps boost items that have been in inventory too long. A scoring profile is part of the index definition, composed of weighted fields, functions, and parameters. You can update an existing index with scoring profile changes, without incurring an index rebuild.|
+| [BM25 algorithm configuration](index-ranking-similarity.md) | Search index | Configure how document length and term frequency affect the relevance score. |
+| [Scoring profiles](index-add-scoring-profiles.md) | Search index | Provide criteria for boosting the search score of a match based on content characteristics. For example, you can boost matches based on their revenue potential, promote newer items, or perhaps boost items that have been in inventory too long. A scoring profile is part of the index definition, composed of weighted fields, functions, and parameters. You can update an existing index with scoring profile changes, without incurring an index rebuild.|
| [Semantic ranking](semantic-search-overview.md) | Query request | Applies machine reading comprehension to search results, promoting more semantically relevant results to the top. |
| [featuresMode parameter](#featuresmode-parameter-preview) | Query request | This parameter is mostly used for unpacking a BM25-ranked score, but it can be used for in code that provides a [custom scoring solution](https://github.com/Azure-Samples/search-ranking-tutorial). |
@@ -173,9 +170,9 @@ The featuresMode parameter isn't documented in the REST APIs, but you can use it
## Number of ranked results in a full text query response
-By default, if you aren't using pagination, the search engine returns the top 50 highest ranking matches for full text search. You can use the `top` parameter to return a smaller or larger number of items (up to 1000 in a single response). Full text search is subject to a maximum limit of 1,000 matches (see [API response limits](search-limits-quotas-capacity.md#api-response-limits)). Once 1,000 matches are found, the search engine no longer looks for more.
+By default, if you aren't using pagination, the search engine returns the top 50 highest ranking matches for full text search. You can use the `top` parameter to return a smaller or larger number of items (up to 1,000 in a single response). You can use `skip` and `next` to page results. Paging determines the number of results on each logical page and supports content navigation. For more information, see [Shape search results](search-pagination-page-layout.md).
-To return more or less results, use the paging parameters `top`, `skip`, and `next`. Paging is how you determine the number of results on each logical page and navigate through the full payload. For more information, see [How to work with search results](search-pagination-page-layout.md).
+Full text search is subject to a maximum limit of 1,000 matches (see [API response limits](search-limits-quotas-capacity.md#api-response-limits)). Once 1,000 matches are found, the search engine no longer looks for more.
## See also
Summary
{
"modification_type": "minor update",
"modification_title": "コンテンツの修正と日付の更新"
}
Explanation
この変更は、index-similarity-and-scoring.md
ファイルにおいて、コンテンツの改善と一部記述の修正、および日付の更新を行うものです。特に、「ms.date」の値が2024年5月6日から2024年12月10日に変更されました。また、いくつかの文がより明確になり、機能的な説明が補足されました。例えば、「ClassicSimilarity」に関する説明や、BM25スコアのカスタマイズオプションに関する内容が分かりやすく改訂されています。
具体的には、いくつかの段落が削除・変更され、内容がよりコンパクトで明瞭に整理されました。この修正により、ユーザーはAzure AI Searchにおけるスコアリングアルゴリズムや関連する機能についての理解を深めることができるようになります。全体として、ドキュメントの信頼性と可読性が向上しています。
articles/search/knowledge-store-concept-intro.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 06/25/2024
+ms.date: 12/10/2024
---
# Knowledge store in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、knowledge-store-concept-intro.md
ファイルの日付を更新するもので、具体的には「ms.date」の値が2024年6月25日から2024年12月10日に変更されました。このアップデートは、ドキュメントの情報が最新であることを保証するためのものであり、ユーザーがreferenceとして使用する際により正確な情報を提供することを目的としています。日付の更新によって、ユーザーはこのコンテンツが最新のものであることを確認できるため、信頼性が向上します。
articles/search/knowledge-store-connect-power-bi.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 03/18/2024
+ms.date: 12/10/2024
---
# Connect a knowledge store with Power BI
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、knowledge-store-connect-power-bi.md
ファイルの「ms.date」フィールドの日付を更新するもので、2024年3月18日から2024年12月10日に変更されました。この修正により、ドキュメントの情報が最新に保たれ、ユーザーに正確な情報を提供することを目的としています。日付の更新は、ユーザーがコンテンツの信頼性を確認できる手助けをし、他の関連する情報との整合性を保つためにも重要です。
articles/search/knowledge-store-create-portal.md
Diff
@@ -7,7 +7,7 @@ ms.author: heidist
manager: nitinme
ms.service: azure-ai-search
ms.topic: quickstart
-ms.date: 03/18/2024
+ms.date: 12/10/2024
ms.custom:
- mode-ui
- ignite-2023
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、knowledge-store-create-portal.md
ファイルにおける「ms.date」の値を更新するものです。具体的には、日付が2024年3月18日から2024年12月10日に変更されました。この修正はドキュメントの最新性を確保するために重要です。更新された日付により、ユーザーはコンテンツが最近のものであることを認識でき、信頼性が向上します。また、関連する他の情報と一致させるためにも、この変更は必要です。
articles/search/knowledge-store-create-rest.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 03/08/2024
+ms.date: 12/10/2024
---
# Create a knowledge store using REST
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、knowledge-store-create-rest.md
ファイル内の「ms.date」フィールドの日付を修正することに関連しています。具体的には、日付が2024年3月8日から2024年12月10日に変更されました。この修正により、ドキュメントの最新情報が保証され、ユーザーがコンテンツの信頼性を確認しやすくなります。また、このような日付の更新は、他の関連する資料やガイドラインとの整合性を保つためにも重要です。
articles/search/knowledge-store-projection-example-long.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 03/08/2024
+ms.date: 12/10/2024
---
# Detailed example of shapes and projections in a knowledge store
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、knowledge-store-projection-example-long.md
ファイル内の「ms.date」フィールドの日付を更新することに関連しています。具体的には、日付が2024年3月8日から2024年12月10日に変更されました。これにより、ドキュメントが最新の状態を反映し、ユーザーが情報の信頼性を確認できるようになります。また、コンテンツの更新は、他の関連資料と整合性を保つためにも不可欠です。この修正は、文書の正確性と信頼性を維持するためのものです。
articles/search/knowledge-store-projection-overview.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 01/18/2024
+ms.date: 12/10/2024
---
# Knowledge store "projections" in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、knowledge-store-projection-overview.md
ファイルの「ms.date」フィールドの日付を修正することに関連しています。具体的には、日付が2024年1月18日から2024年12月10日に変更されました。この更新により、ドキュメントが最新情報を正確に反映し、読者が内容の信頼性を確認しやすくなります。また、関連する他のドキュメントとの整合性を保つためにも、こうした日付の更新は重要です。全体として、この修正はユーザーに提供される情報の質を向上させるためのものです。
articles/search/knowledge-store-projection-shape.md
Diff
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 03/18/2024
+ms.date: 12/10/2024
---
# Shaping data for projection into a knowledge store
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、knowledge-store-projection-shape.md
ファイル内の「ms.date」フィールドの日付を更新することに関連しています。具体的には、日付が2024年3月18日から2024年12月10日に変更されました。この修正により、ドキュメントが最新の情報となり、読者が内容の信頼性を確認しやすくなります。また、このような日付の更新は、その他の関連ドキュメントとの一貫性を保つためにも重要です。全体として、この修正は情報を最新の状態に保つためのものであり、ユーザーに対する情報提供の質を向上させることを目的としています。
articles/search/knowledge-store-projections-examples.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 03/18/2024
+ms.date: 12/10/2024
---
# Define projections in a knowledge store
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、knowledge-store-projections-examples.md
ファイルの「ms.date」フィールドの日付を修正することに関するものです。具体的には、日付が2024年3月18日から2024年12月10日に変更されました。この変更により、ドキュメントが最新の情報を反映し、ユーザーが情報の信頼性を確認しやすくなります。また、関連するドキュメントとの整合性を保つためにも、これらの日付の更新は重要です。この修正は全体として、提供される情報の質を向上させる目的で行われました。
articles/search/policy-reference.md
Diff
@@ -1,7 +1,7 @@
---
title: Built-in policy definitions for Azure Cognitive Search
description: Lists Azure Policy built-in policy definitions for Azure Cognitive Search. These built-in policy definitions provide common approaches to managing your Azure resources.
-ms.date: 02/06/2024
+ms.date: 12/10/2024
ms.topic: reference
author: HeidiSteen
ms.author: heidist
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、policy-reference.md
ファイルにおける「ms.date」フィールドの日付を更新する内容です。具体的には、日付が2024年2月6日から2024年12月10日に修正されました。この変更により、ドキュメントは最新の情報を反映し、ユーザーが適切な情報にアクセスしやすくなります。また、他の関連ドキュメントとの整合性を保つためにも、日付の更新が重要です。この修正は、ドキュメントの信頼性を向上させ、ユーザーに対して正確な情報を提供することを目的としています。
articles/search/query-odata-filter-orderby-syntax.md
Diff
@@ -7,7 +7,7 @@ author: bevloh
ms.author: beloh
ms.service: azure-ai-search
ms.topic: conceptual
-ms.date: 08/19/2024
+ms.date: 12/10/2024
---
# OData language overview for `$filter`, `$orderby`, and `$select` in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、query-odata-filter-orderby-syntax.md
ファイル内の「ms.date」フィールドの日付を更新する内容です。変更前の日付は2024年8月19日でしたが、2024年12月10日に修正されました。この修正により、ドキュメントは最新の情報を反映し、ユーザーが正確なコンテンツにアクセスできるようになります。この種の日付更新は、文書の整合性と信頼性を維持するために重要であり、ユーザーが最新の開発状況を把握するのに役立ちます。
articles/search/query-simple-syntax.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 01/17/2024
+ms.date: 12/10/2024
---
# Simple query syntax in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、query-simple-syntax.md
ファイルにおける「ms.date」フィールドの日付を更新する内容です。古い日付は2024年1月17日でしたが、新しい日付は2024年12月10日に変更されました。この更新は、ドキュメントが最新の情報を反映することを目的としており、ユーザーが正確なコンテンツにアクセスできるようにします。また、日付の更新は、ドキュメントの整合性を保つためにも重要であり、関連する情報との一貫性を維持する役割も果たします。
articles/search/resource-partners-knowledge-mining.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 02/26/2024
+ms.date: 12/10/2024
---
# Partner spotlight
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、resource-partners-knowledge-mining.md
ファイルにおける「ms.date」フィールドの日付を更新する内容です。変更前の日付は2024年2月26日でしたが、2024年12月10日に修正されました。この更新により、ドキュメントは最新の情報を反映し、ユーザーがより正確で信頼性のある内容を得られることを目指しています。日付の更新は、コンテンツの鮮度を確保するだけでなく、関連するリソースやパートナー情報との整合性を保つためにも重要です。
articles/search/search-data-sources-terms-of-use.md
Diff
@@ -8,7 +8,7 @@ ms.author: heidist
ms.service: azure-ai-search
ms.custom:
- ignite-2023
-ms.topic: conceptual
+ms.topic: reference
ms.date: 01/10/2024
---
Summary
{
"modification_type": "minor update",
"modification_title": "トピックの種類の更新"
}
Explanation
この変更は、search-data-sources-terms-of-use.md
ファイルにおいて、「ms.topic」フィールドの値を更新するものです。旧値は「conceptual」で、新値は「reference」に変更されました。この修正により、ドキュメントの性質がより適切に反映されることを目的としています。「reference」としての分類は、ユーザーが情報を参照しやすくし、検索データソースに関する用語や使用条件についての理解を深めるのに役立ちます。また、この変更は他の関連情報とも一貫性を保つために重要です。
articles/search/search-dotnet-sdk-migration-version-11.md
Diff
@@ -9,7 +9,7 @@ ms.author: heidist
ms.service: azure-ai-search
ms.devlang: csharp
ms.topic: conceptual
-ms.date: 10/19/2023
+ms.date: 12/10/2024
ms.custom:
- devx-track-csharp
- devx-track-dotnet
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-dotnet-sdk-migration-version-11.md
ファイルの「ms.date」フィールドの日付を更新するものです。変更前の日付は2023年10月19日でしたが、2024年12月10日に修正されました。この更新によって、ドキュメントが最新の情報を反映するようになり、特に.NET SDKの移行に関するユーザーに対して正確なデータを提供することが狙いです。日付の更新は、コンテンツの信頼性を向上させ、関連するリソースや文書との整合性を保つために重要です。
articles/search/search-get-started-bicep.md
Diff
@@ -11,7 +11,7 @@ ms.custom:
- mode-arm
- devx-track-bicep
- ignite-2023
-ms.date: 02/26/2024
+ms.date: 12/10/2024
---
# Quickstart: Deploy Azure AI Search using Bicep
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-get-started-bicep.md
ファイルの「ms.date」フィールドの日付を更新するものです。修正前の日付は2024年2月26日であり、変更後は2024年12月10日となりました。この更新は、Bicepを使用してAzure AI Searchをデプロイする際のスタートガイドが最新の情報を反映することを目的としています。日付の修正により、読者に提供されるコンテンツの正確性と信頼性が向上します。また、最新のリソースやドキュメントとの整合性を維持することが重要であり、ユーザーに対して適切なタイムスタンプを提供する役割も果たしています。
articles/search/search-get-started-terraform.md
Diff
@@ -2,7 +2,7 @@
title: 'Quickstart: Deploy using Terraform'
description: 'In this article, you create an Azure AI Search service using Terraform.'
ms.topic: quickstart
-ms.date: 02/16/2024
+ms.date: 12/10/2024
ms.custom:
- devx-track-terraform
- ignite-2023
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-get-started-terraform.md
ファイル内の「ms.date」フィールドの日付を更新するもので、変更前の日付は2024年2月16日でしたが、変更後は2024年12月10日となりました。この更新は、Terraformを使用してAzure AI Searchサービスをデプロイするためのクイックスタートガイドが最新の情報を反映することを目的としています。日付の変更により、ドキュメントの内容が正確かつ信頼性のあるものとなり、読者に対して適切なタイムスタンプを提供する役割を果たします。これにより、ユーザーは最新の情報に基づいてサービスを利用することが可能になります。
articles/search/search-how-to-alias.md
Diff
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 06/25/2024
+ms.date: 12/10/2024
---
# Create an index alias in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-how-to-alias.md
ファイル内の「ms.date」フィールドの日付を更新するものです。修正前の日付は2024年6月25日で、変更後の日付は2024年12月10日となりました。この更新は、Azure AI Searchでインデックスエイリアスを作成する方法に関するガイドが最新の情報を反映することを目指しています。日付の修正により、提供されるコンテンツが最新であることを保証し、読者に正確な情報を提供できるようになるため、信頼性が向上します。これにより、ユーザーは最新の手法やリソースに基づいて作業を行うことが可能になります。
articles/search/search-how-to-define-index-projections.md
Diff
@@ -292,8 +292,7 @@ For data sources that provide change tracking and deletion detection, an indexer
If you add new content to your data source, new chunks or child documents are added to the index on the next indexer run.
-If you modify existing content in the data source, chunks are updated incrementally in the search index if the data source you're using supports change tracking and deletion detection. For exammple, if a word or sentence changes in a document, the chunk in the target index that contains that word or sentence is updated on the next indexer run. Other types of updates, such as changing a field type and some attributions, aren't supported for existing fields. For more information about allowed updates, see [
-Change an index schema](search-howto-reindex.md#change-an-index-schema).
+If you modify existing content in the data source, chunks are updated incrementally in the search index if the data source you're using supports change tracking and deletion detection. For exammple, if a word or sentence changes in a document, the chunk in the target index that contains that word or sentence is updated on the next indexer run. Other types of updates, such as changing a field type and some attributions, aren't supported for existing fields. For more information about allowed updates, see [Update an index schema](search-howto-reindex.md#update-an-index-schema).
Some data sources like [Azure Storage](search-howto-index-changed-deleted-blobs.md) support change and deletion tracking by default, based on the timestamp. Other data sources such as [OneLake](search-how-to-index-onelake-files.md), [Azure SQL](search-how-to-index-sql-database.md), or [Azure Cosmos DB](search-howto-index-cosmosdb.md) must be configured for change tracking.
Summary
{
"modification_type": "minor update",
"modification_title": "リンクテキストの修正"
}
Explanation
この変更は、search-how-to-define-index-projections.md
ファイル内の一部のテキストを修正するもので、特にインデックススキーマの更新に関するリンクテキストが変更されました。具体的には、「Change an index schema」という表現が「Update an index schema」に修正されており、これにより、ドキュメントの内容がより正確で一貫性のあるものとなっています。
この修正は、ユーザーがインデックスのスキーマを更新する手続きに関する正しい情報にアクセスできるようにするためのものであり、誤解を避ける助けとなります。また、既存のフィールドに対応する更新の詳細についての情報が明確に指摘されています。このように、ユーザーは特定の手続きやガイドラインに従って、Azure AI Searchのインデックスプロジェクションを適切に管理することができます。
articles/search/search-how-to-index-sql-managed-instance.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 05/23/2024
+ms.date: 12/10/2024
---
# Indexer connections to Azure SQL Managed Instance through a public endpoint
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-how-to-index-sql-managed-instance.md
ファイルにおける「ms.date」フィールドの日付を修正することに関連しています。具体的には、旧日付である2024年5月23日が新しい日付である2024年12月10日に更新されました。この修正は、Azure SQL Managed Instanceを通じてインデクサー接続に関するドキュメントが最新の情報を基にしていることを保証することを目的としています。
日付の更新は、コンテンツが正確であり、利用者が最新の技術や手法に基づいてインデクサー接続の設定を行えるようにするために重要です。このようにして、ユーザーは信頼性の高い情報をもとに作業を行い、適切な手続きに従うことができます。
articles/search/search-how-to-index-sql-server.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 05/01/2024
+ms.date: 12/10/2024
---
# Indexer connections to a SQL Server instance on an Azure virtual machine
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-how-to-index-sql-server.md
ファイルの「ms.date」フィールドの日付を更新するもので、旧日付である2024年5月1日から新しい日付である2024年12月10日へと変更されました。この修正は、SQL Serverインスタンスのインデクサー接続に関するドキュメントが最新の情報を反映することを目的としています。
日付の更新により、ユーザーはこの記事が最新の技術や手法を反映していることを確認できます。これは特に重要で、利用者が信頼できる情報に基づいてSQL Serverのインデクサー接続を適切に設定できるようにする役割を果たします。これにより、ユーザーの理解が深まり、実際の作業において役立つリソースとなります。
articles/search/search-howto-incremental-index.md
Diff
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 06/25/2024
+ms.date: 12/10/2024
---
# Enable caching for incremental enrichment in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-howto-incremental-index.md
ファイルにおいて「ms.date」フィールドの日付を更新することに関するもので、旧日付の2024年6月25日が新しい日付の2024年12月10日に変更されました。この修正は、Azure AI Searchにおけるインクリメンタルエンリッチメントのキャッシングを有効にする方法に関するドキュメントが最新の情報に基づいていることを保証することを目的としています。
日付の更新を行うことで、ユーザーはドキュメントの内容が現在の技術トレンドやベストプラクティスに合致していると確認できるため、信頼性が高まります。これにより、ユーザーはインクリメンタルインデックスの設定に関して、最新の情報を基にして適切にアクションをとることができます。
articles/search/search-howto-index-azure-data-lake-storage.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 08/23/2024
+ms.date: 12/10/2024
---
# Index data from Azure Data Lake Storage Gen2
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-howto-index-azure-data-lake-storage.md
ファイルにおいて「ms.date」フィールドの日付を更新するもので、旧日付の2024年8月23日から新しい日付の2024年12月10日に変更されています。この修正は、Azure Data Lake Storage Gen2からのデータインデクシングに関するドキュメントが最新の情報を反映することを目的としています。
日付を更新することで、ユーザーはこのドキュメントが最新の技術情報を基にしていると確認することができ、信頼性が向上します。これにより、Azure Data Lake Storageのインデクス作成を行う際に、適切で最新な手法に基づいたリソースを活用できるようになります。この変更は、利用者の理解を助け、実用的なガイダンスを提供する役割を果たします。
articles/search/search-howto-index-cosmosdb-gremlin.md
Diff
@@ -11,7 +11,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 02/28/2024
+ms.date: 12/10/2024
---
# Index data from Azure Cosmos DB for Apache Gremlin for queries in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-howto-index-cosmosdb-gremlin.md
ファイルにおいて「ms.date」フィールドの日付を更新することに関するもので、旧日付の2024年2月28日が新しい日付の2024年12月10日に変更されています。この修正は、Azure AI Searchを使用してApache Gremlinのクエリ用にAzure Cosmos DBからデータをインデクシングする方法に関するドキュメントの最新化を目的としています。
この日付の更新により、ユーザーはドキュメントが最新の情報を基にしていることを確認でき、信頼性が高まります。また、利用者はインデクシングの手法に関する最新の指針や実践にアクセスできるようになります。この改訂は、Azure Cosmos DBとAzure AI Searchを効果的に使用するための重要なリソースの適切な更新を反映しています。
articles/search/search-howto-index-cosmosdb-mongodb.md
Diff
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 06/25/2024
+ms.date: 12/10/2024
---
# Index data from Azure Cosmos DB for MongoDB for queries in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-howto-index-cosmosdb-mongodb.md
ファイルにおける「ms.date」フィールドの日付を更新するものです。旧日付の2024年6月25日から、新しい日付の2024年12月10日に変更されています。この修正は、Azure AI Searchを使用してMongoDBに基づくAzure Cosmos DBからデータをインデクシングする方法に関するドキュメントの内容を最新化することを目的としています。
この日付の更新により、文書が最新の情報を反映していることを利用者が確認できます。これにより、ユーザーはインデクシングのプロセスに関して最新の指針に基づいた情報を得ることが可能となり、Azure Cosmos DBとAzure AI Searchを効果的に使用できるリソースとしての信頼性が向上します。この変更により、関連する技術の理解を深め、実践的な手法を提供することが期待されます。
articles/search/search-howto-index-mysql.md
Diff
@@ -12,7 +12,7 @@ ms.topic: how-to
ms.custom:
- kr2b-contr-experiment
- ignite-2023
-ms.date: 06/25/2024
+ms.date: 12/10/2024
---
# Index data from Azure Database for MySQL flexible server
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-howto-index-mysql.md
ファイルにおける「ms.date」フィールドの日付を更新することに関するものです。旧日付の2024年6月25日が新しい日付の2024年12月10日に変更されています。この修正は、Azure Database for MySQLのフレキシブルサーバーにおけるデータのインデクシング方法に関するドキュメントの最新化を目的としています。
日付の更新により、利用者はその文書が最新の情報を基にしていることを認識でき、情報の信頼性が向上します。この改訂によって、Azure Database for MySQLを使用する際のデータインデクシングに関する指針が最新のベストプラクティスを反映していることが確認でき、ユーザーは新しい手法や改善点を容易に見つけることができます。
articles/search/search-howto-managed-identities-sql.md
Diff
@@ -10,7 +10,7 @@ ms.custom:
- ignite-2023
ms.service: azure-ai-search
ms.topic: how-to
-ms.date: 02/22/2024
+ms.date: 12/10/2024
---
# Set up an indexer connection to Azure SQL using a managed identity
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-howto-managed-identities-sql.md
ファイルにおける「ms.date」フィールドの日付を更新するもので、旧日付の2024年2月22日から新しい日付の2024年12月10日に変更されています。この修正は、Azure SQLへのマネージドアイデンティティを使用したインデクサー接続の設定に関するドキュメントの内容を最新化することを目的としています。
この日付の更新により、この文書が最新の情報を反映していることがユーザーに伝わります。これは、Azure AI Searchを利用する際の適切な設定手順を知るための重要なリソースとなっており、ユーザーが最新のベストプラクティスや手法を理解するのに役立ちます。文書の信頼性が向上し、利用者は最新の技術に基づいた情報にアクセス可能となります。
articles/search/search-howto-move-across-regions.md
Diff
@@ -11,7 +11,7 @@ ms.topic: how-to
ms.custom:
- subject-moving-resources
- ignite-2023
-ms.date: 01/11/2024
+ms.date: 12/10/2024
---
# Move your Azure AI Search service to another Azure region
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-howto-move-across-regions.md
ファイル内で「ms.date」フィールドの日付を更新するもので、旧日付の2024年1月11日が新しい日付の2024年12月10日に変更されています。この修正は、Azure AI Searchサービスを別のAzureリージョンに移動する方法に関するドキュメントの最新化を目的としています。
日付の変更により、この文書が最新の内容を反映していることが明確になり、ユーザーが最新の情報に基づいて作業を進められるようになります。この更新は、Azureサービスを利用する際の重要なプロセスに関して、ユーザーが適切かつ最新の手順を理解する手助けとなり、情報の信頼性を確保するために重要です。
articles/search/search-howto-reindex.md
Diff
@@ -11,7 +11,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2024
ms.topic: how-to
-ms.date: 08/14/2024
+ms.date: 12/09/2024
---
# Update or rebuild an index in Azure AI Search
@@ -20,28 +20,126 @@ This article explains how to update an existing index in Azure AI Search with sc
During active development, it's common to drop and rebuild indexes when you're iterating over index design. Most developers work with a small representative sample of their data so that reindexing goes faster.
-For schema changes on applications already in production, we recommend creating and testing a new index that runs side by side an existing index. Use an [index alias](search-how-to-alias.md) to swap in the new index while avoiding changes your application code.
+For schema changes on applications already in production, we recommend creating and testing a new index that runs side by side an existing index. Use an [index alias](search-how-to-alias.md) to swap in the new index so that you can avoid changes your application code.
## Update content
-Incremental indexing and synchronizing an index against changes in source data is fundamental to most search applications. This section explains the workflow for updating field contents in a search index.
+Incremental indexing and synchronizing an index against changes in source data is fundamental to most search applications. This section explains the workflow for updating field contents in a search index through the REST API, but the Azure SDKs provide equivalent functionality.
-1. Use the same techniques for loading documents: [Documents - Index (REST)](/rest/api/searchservice/documents) or an equivalent API in the Azure SDKs. For more information about indexing techniques, see [Load documents](search-how-to-load-search-index.md).
+The body of the request contains one or more documents to be indexed. Documents are identified by a unique case-sensitive key. Each document is associated with an action: "upload", "delete", "merge", or "mergeOrUpload". Upload requests must include the document data as a set of key/value pairs.
-1. Set the `@search.action` parameter to determine the effect on existing documents:
+```json
+{
+ "value": [
+ {
+ "@search.action": "upload (default) | merge | mergeOrUpload | delete",
+ "key_field_name": "unique_key_of_document", (key/value pair for key field from index schema)
+ "field_name": field_value (key/value pairs matching index schema)
+ ...
+ },
+ ...
+ ]
+}
+```
+
++ First, use the APIs for loading documents, such as [Documents - Index (REST)](/rest/api/searchservice/documents) or an equivalent API in the Azure SDKs. For more information about indexing techniques, see [Load documents](search-how-to-load-search-index.md).
+
++ For a large update, batching (up to 1,000 documents per batch, or about 16 MB per batch, whichever limit comes first) is recommended and significantly improves indexing performance.
+
++ Set the `@search.action` parameter on the API to determine the effect on existing documents.
| Action | Effect |
|--------|--------|
| delete | Removes the entire document from the index. If you want to remove an individual field, use merge instead, setting the field in question to null. Deleted documents and fields don't immediately free up space in the index. Every few minutes, a background process performs the physical deletion. Whether you use the Azure portal or an API to return index statistics, you can expect a small delay before the deletion is reflected in the Azure portal and through APIs. |
- | merge | Updates a document that already exists, and fails a document that can't be found. Merge replaces existing values. For this reason, be sure to check for collection fields that contain multiple values, such as fields of type `Collection(Edm.String)`. For example, if a `tags` field starts with a value of `["budget"]` and you execute a merge with `["economy", "pool"]`, the final value of the `tags` field is `["economy", "pool"]`. It won't be `["budget", "economy", "pool"]`. |
+ | merge | Updates a document that already exists, and fails a document that can't be found. Merge replaces existing values. For this reason, be sure to check for collection fields that contain multiple values, such as fields of type `Collection(Edm.String)`. For example, if a `tags` field starts with a value of `["budget"]` and you execute a merge with `["economy", "pool"]`, the final value of the `tags` field is `["economy", "pool"]`. It won't be `["budget", "economy", "pool"]`. <br><br>The same behavior applies to complex collections. If the document contains a complex collection field named Rooms with a value of `[{ "Type": "Budget Room", "BaseRate": 75.0 }]`, and you execute a merge with a value of `[{ "Type": "Standard Room" }, { "Type": "Budget Room", "BaseRate": 60.5 }]`, the final value of the Rooms field will be `[{ "Type": "Standard Room" }, { "Type": "Budget Room", "BaseRate": 60.5 }]`. It won't append or merge new and existing values. |
| mergeOrUpload | Behaves like merge if the document exists, and upload if the document is new. This is the most common action for incremental updates. |
| upload | Similar to an "upsert" where the document is inserted if it's new, and updated or replaced if it exists. If the document is missing values that the index requires, the document field's value is set to null. |
-1. Post the update.
+Queries continue to run during indexing, but if you're updating or removing existing fields, you can expect mixed results and a higher incidence of throttling.
+
+> [!NOTE]
+> There are no ordering guarantees for which action in the request body is executed first. It's not recommended to have multiple "merge" actions associated with the same document in a single request body. If there are multiple "merge" actions required for the same document, perform the merging client-side before updating the document in the search index.
+
+### Responses
+
+Status code 200 is returned for a successful response, meaning that all items have been stored durably and will start to be indexed. Indexing runs in the background and makes new documents available (that is, queryable and searchable) a few seconds after the indexing operation completed. The specific delay depends on the load on the service.
+
+Successful indexing is indicated by the status property being set to true for all items, as well as the `statusCode` property being set to either 201 (for newly uploaded documents) or 200 (for merged or deleted documents):
+
+```json
+{
+ "value": [
+ {
+ "key": "unique_key_of_new_document",
+ "status": true,
+ "errorMessage": null,
+ "statusCode": 201
+ },
+ {
+ "key": "unique_key_of_merged_document",
+ "status": true,
+ "errorMessage": null,
+ "statusCode": 200
+ },
+ {
+ "key": "unique_key_of_deleted_document",
+ "status": true,
+ "errorMessage": null,
+ "statusCode": 200
+ }
+ ]
+}
+```
+
+Status code 207 is returned when at least one item wasn't successfully indexed. Items that haven't been indexed have the status field set to false. The `errorMessage` and `statusCode` properties indicate the reason for the indexing error:
-Queries continue to run, but if you're updating or removing existing fields, you can expect mixed results and a higher incidence of throttling.
+```json
+{
+ "value": [
+ {
+ "key": "unique_key_of_document_1",
+ "status": false,
+ "errorMessage": "The search service is too busy to process this document. Please try again later.",
+ "statusCode": 503
+ },
+ {
+ "key": "unique_key_of_document_2",
+ "status": false,
+ "errorMessage": "Document not found.",
+ "statusCode": 404
+ },
+ {
+ "key": "unique_key_of_document_3",
+ "status": false,
+ "errorMessage": "Index is temporarily unavailable because it was updated with the 'allowIndexDowntime' flag set to 'true'. Please try again later.",
+ "statusCode": 422
+ }
+ ]
+}
+```
+
+The `errorMessage` property indicates the reason for the indexing error if possible.
+
+The following table explains the various per-document status codes that can be returned in the response. Some status codes indicate problems with the request itself, while others indicate temporary error conditions. The latter you should retry after a delay.
+
+| Status code | Meaning | Retryable | Notes |
+|-------------|---------|-----------|-------|
+| 200 | Document was successfully modified or deleted. | n/a | Delete operations are idempotent. That is, even if a document key doesn't exist in the index, attempting a delete operation with that key results in a 200 status code. |
+| 201 | Document was successfully created. | n/a | |
+| 400 | There was an error in the document that prevented it from being indexed. | No | The error message in the response indicates what is wrong with the document.|
+| 404 | The document couldn't be merged because the given key doesn't exist in the index. | No | This error doesn't occur for uploads since they create new documents, and it doesn't occur for deletes because they're idempotent. |
+| 409 | A version conflict was detected when attempting to index a document.| Yes | This can happen when you're trying to index the same document more than once concurrently. |
+| 422 | The index is temporarily unavailable because it was updated with the 'allowIndexDowntime' flag set to 'true'. | Yes | |
+| 503 | Your search service is temporarily unavailable, possibly due to heavy load. | Yes | Your code should wait before retrying in this case or you risk prolonging the service unavailability.|
-## Tips for incremental indexing
+If your client code frequently encounters a 207 response, one possible reason is that the system is under load. You can confirm this by checking the statusCode property for 503. If the statusCode is 503, we recommend throttling indexing requests. Otherwise, if indexing traffic doesn't subside, the system could start rejecting all requests with 503 errors.
+
+Status code 429 indicates that you have exceeded your quota on the number of documents per index. You must either create a new index or upgrade for higher capacity limits.
+
+> [!NOTE]
+> When you upload `DateTimeOffset` values with time zone information to your index, Azure AI Search normalizes these values to UTC. For example, 2024-01-13T14:03:00-08:00 is stored as 2024-01-13T22:03:00Z. If you need to store time zone information, add an extra column to your index for this data point.
+
+### Tips for incremental indexing
+ [Indexers automate incremental indexing](search-indexer-overview.md). If you can use an indexer, and if the data source supports change tracking, you can run the indexer on a recurring schedule to add, update, or overwrite searchable content so that it's synchronized to your external data.
@@ -88,18 +186,22 @@ GET {{baseUrl}}/indexes/hotels-vector-quickstart/docs('1')?api-version=2024-07-
api-key: {{apiKey}}
```
-## Change an index schema
+## Update an index schema
+
+The index schema defines the physical data structures created on the search service, so there aren't many schema changes that you can make without incurring a full rebuild.
-The index schema defines the physical data structures created on the search service, so there aren't many schema changes that you can make without incurring a full rebuild. The following list enumerates the schema changes that can be introduced seamlessly into an existing index. Generally, the list includes new fields and functionality used during query execution.
+### Updates with no rebuild
+
+The following list enumerates the schema changes that can be introduced seamlessly into an existing index. Generally, the list includes new fields and functionality used during query execution.
+ Add a new field
+ Set the `retrievable` attribute on an existing field
+ Update `searchAnalyzer` on a field having an existing `indexAnalyzer`
-+ Add a new analyzer definition in an index (which can be applied to new fields)
-+ Add, update, or delete scoring profiles
++ Add a new [analyzer definition](index-add-custom-analyzers.md) in an index (which can be applied to new fields)
++ Add, update, or delete [scoring profiles](index-add-scoring-profiles.md)
++ Add, update, or delete [synonymMaps](search-synonyms.md)
++ Add, update, or delete [semantic configurations](semantic-how-to-configure.md)
+ Add, update, or delete CORS settings
-+ Add, update, or delete synonymMaps
-+ Add, update, or delete semantic configurations
The order of operations is:
@@ -115,7 +217,7 @@ When you update an index schema to include a new field, existing documents in th
There should be no query disruptions during the updates, but query results will vary as the updates take effect.
-## Drop and rebuild an index
+### Updates requiring a rebuild
Some modifications require an index drop and rebuild, replacing a current index with a new one.
@@ -144,6 +246,8 @@ The order of operations is:
When you create the index, physical storage is allocated for each field in the index schema, with an inverted index created for each searchable field and a vector index created for each vector field. Fields that aren't searchable can be used in filters or expressions, but don't have inverted indexes and aren't full-text or fuzzy searchable. On an index rebuild, these inverted indexes and vector indexes are deleted and recreated based on the index schema you provide.
+To minimize disruption to application code, consider [creating an index alias](search-how-to-alias.md). Application code references the alias, but you can update the name of the index that the alias points to.
+
## Balancing workloads
Indexing doesn't run in the background, but the search service will balance any indexing jobs against ongoing queries. During indexing, you can [monitor query requests](search-monitor-queries.md) in the Azure portal to ensure queries are completing in a timely manner.
@@ -156,7 +260,13 @@ You can begin querying an index as soon as the first document is loaded. If you
You can use [Search Explorer](search-explorer.md) or a [REST client](search-get-started-rest.md) to check for updated content.
-If you added or renamed a field, use [$select](search-query-odata-select.md) to return that field: `search=*&$select=document-id,my-new-field,some-old-field&$count=true`.
+If you added or renamed a field, use [select](search-query-odata-select.md) to return that field:
+
+```json
+"search": "*",
+"select": "document-id, my-new-field, some-old-field",
+"count": true
+```
The Azure portal provides index size and vector index size. You can check these values after updating an index, but remember to expect a small delay as the service processes the change and to account for portal refresh rates, which can be a few minutes.
Summary
{
"modification_type": "minor update",
"modification_title": "検索インデックスの再構築に関する更新"
}
Explanation
この変更は、search-howto-reindex.md
ファイルに対して行われたもので、内容が大幅に更新され、具体的には127行が追加され、17行が削除され、合計で144行の変更が加えられました。主な目的は、Azure AI Searchのインデックスの更新および再構築に関する手順と情報を最新化することです。
変更点としては、インデックスの更新方法に関する具体的な手順や注意点が追加され、特にREST APIを通じたフィールドコンテンツの更新ワークフローが説明されています。また、新しいインデックスを作成する際に使用するべきAPIの詳細や、リクエスト本文に含めるべきアクションの具体例、さらには成功したレスポンスの形式も示されています。さらに、アクセスポイントに対する注意事項や推奨される手法、インデックス作成に際しての状態コードの解釈など、多岐にわたる情報が盛り込まれています。
このような更新によって、ユーザーはAzure AI Searchのインデックスを効率的かつ効果的に管理できるようになり、特に大きな更新を行う際のパフォーマンスを最適化しやすくなっています。全体として、このドキュメントは検索インデックスの運用に関して非常に役立つリソースとなります。
articles/search/search-index-azure-sql-managed-instance-with-managed-identity.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 10/18/2023
+ms.date: 12/10/2024
---
# Set up an indexer connection to Azure SQL Managed Instance using a managed identity
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-index-azure-sql-managed-instance-with-managed-identity.md
ファイルにおいて、日付フィールド「ms.date」を2023年10月18日から2024年12月10日に更新する内容です。この変更は、Azure SQL Managed Instanceに対するインデクサ接続をセットアップするための文書を最新の情報に合わせることを目的としています。
日付の更新により、ドキュメントが現在の状態を反映していることが強調され、利用者が最新の手順情報を基に作業を行うことができます。このような更新は、特に技術文書において重要であり、ユーザーが信頼性のある情報を受け取ることを確実にします。
articles/search/search-indexer-how-to-access-private-sql.md
Diff
@@ -7,7 +7,7 @@ author: mattgotteiner
ms.author: magottei
ms.service: azure-ai-search
ms.topic: how-to
-ms.date: 05/23/2024
+ms.date: 12/10/2024
---
# Create a shared private link for a SQL managed instance from Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-indexer-how-to-access-private-sql.md
ファイルにおいて、日付フィールド「ms.date」を2024年5月23日から2024年12月10日に更新するものです。この変更は、Azure AI SearchからSQLマネージドインスタンスへの共有プライベートリンクを作成する手順に関連するドキュメントを最新の情報に合わせることを目的としています。
日付の変更により、ドキュメントが最新の状態を反映しており、ユーザーが信頼性の高い情報を基に作業を行えるようになります。このような更新は、技術文書において正確さと信頼性を保つために重要です。
articles/search/search-indexer-howto-access-ip-restricted.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 05/01/2024
+ms.date: 12/10/2024
---
# Configure IP firewall rules to allow indexer connections from Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-indexer-howto-access-ip-restricted.md
ファイルにおいて、日付フィールド「ms.date」を2024年5月1日から2024年12月10日に更新するものです。この変更は、Azure AI Searchからのインデクサ接続を許可するためのIPファイアウォールルールの設定手順を最新の情報に合わせることを目的としています。
日付の更新により、ドキュメントが現在の状況を反映し、利用者が最新の手順情報を基に作業を行うことができるようになります。技術文書におけるこのような更新は、ユーザーに対して正確で信頼性のある情報を提供するために重要です。
articles/search/search-indexer-howto-access-trusted-service-exception.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 01/18/2024
+ms.date: 12/10/2024
---
# Make indexer connections to Azure Storage as a trusted service
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-indexer-howto-access-trusted-service-exception.md
ファイルにおいて、日付フィールド「ms.date」を2024年1月18日から2024年12月10日に更新するものです。この変更は、Azure Storageに対するインデクサ接続を信頼されたサービスとして行う手順を最新の状態に保つことを目的としています。
日付が更新されることで、ドキュメントが最新の情報を反映し、利用者が最新の手順に基づいて作業を行えるようになります。このような更新は、技術文書の正確さと信頼性を維持するために重要です。
articles/search/search-indexer-troubleshooting.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 06/25/2024
+ms.date: 12/10/2024
---
# Indexer troubleshooting guidance for Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-indexer-troubleshooting.md
ファイルにおける日付フィールド「ms.date」を2024年6月25日から2024年12月10日に更新するものです。この更新は、Azure AI Searchにおけるインデクサのトラブルシューティングガイダンスを最新の状態に保つことを目的としており、利用者が信頼できる情報に基づいて問題解決を行えるようにします。
日付が更新されることで、ドキュメントに反映される情報が現在の状況に適合し、ユーザーが最新のトラブルシューティング手順を参考にできるようになります。このようなメンテナンスは、技術文書の信頼性と有効性を保つために不可欠です。
articles/search/search-language-support.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 01/11/2024
+ms.date: 12/10/2024
---
# Create an index for multiple languages in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-language-support.md
ファイルに関して、日付フィールド「ms.date」を2024年1月11日から2024年12月10日に更新するものです。この更新の目的は、Azure AI Searchで複数言語対応のインデックスを作成する手順を最新の状態に保つことです。
日付が更新されることにより、ドキュメントは新しい情報を反映し、利用者が最新の手順に基づいて作業を行えるようにします。この種の更新は、技術文書が信頼性を持ち、利用者に常に有用な情報を提供するために重要です。
articles/search/search-limits-quotas-capacity.md
Diff
@@ -198,17 +198,18 @@ Static rate request limits for operations related to a service:
+ Service Statistics (GET /servicestats): 4 per second per search unit
-### Semantic Ranker Throttling limits
+### Semantic ranker throttling limits
[Semantic ranker](search-get-started-semantic.md) uses a queuing system to manage concurrent requests. This system allows search services get the highest number of queries per second possible. When the limit of concurrent requests is reached, additional requests are placed in a queue. If the queue is full, further requests are rejected and must be retried.
Total semantic ranker queries per second varies based on the following factors:
-+ The SKU of the search service. Both queue capacity and concurrent request limits vary by SKU.
+
++ The tier of the search service. Both queue capacity and concurrent request limits vary by tier.
+ The number of search units in the search service. The simplest way to increase the maximum number of concurrent semantic ranker queries is to [add more search units to your search service](search-capacity-planning.md#how-to-change-capacity).
+ The total available semantic ranker capacity in the region.
+ The amount of time it takes to serve a query using semantic ranker. This varies based on how busy the search service is.
-The following table describes the semantic ranker throttling limits by SKU. Subject to available capacity in the region, contact support to request a limit increase.
+The following table describes the semantic ranker throttling limits by tier, subject to available capacity in the region. You can contact Microsoft support to request a limit increase.
| Resource | Basic | S1 | S2 | S3 | S3-HD | L1 | L2 |
|----------|-------|----|----|----|-------|----|----|
Summary
{
"modification_type": "minor update",
"modification_title": "セマンティックランカーの制限に関する情報の更新"
}
Explanation
この変更は、search-limits-quotas-capacity.md
ファイルに対して行われたもので、セマンティックランカーに関連する制限に関する情報をいくつか更新しました。具体的には、セマンティックランカーのスロットリング制限の見出しを「Semantic Ranker Throttling limits」から「Semantic ranker throttling limits」に修正し、説明の内容を強化しました。
新たに「Service Statistics (GET /servicestats)」のリクエスト制限についての情報が追加され、また、セマンティックランカーのクエリ制限に関して「SKU」から「tier」への言及に変更されました。これらの変更により、ドキュメントの意図がより明確になり、利用者がどのような要因がスロットリングに影響するかを理解するのに役立ちます。このような更新は、ユーザーに対してより正確で最新の情報を提供するために不可欠です。
articles/search/search-manage-azure-cli.md
Diff
@@ -11,7 +11,7 @@ ms.custom:
- devx-track-azurecli
- ignite-2023
ms.topic: how-to
-ms.date: 04/05/2024
+ms.date: 12/10/2024
---
# Manage your Azure AI Search service with the Azure CLI
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-manage-azure-cli.md
ファイルにおいて、日付フィールド「ms.date」を2024年4月5日から2024年12月10日に更新するものです。この日付の更新は、Azure CLIを使用してAzure AI Searchサービスを管理するための情報を新しい日付で反映させることを目的としています。
更新された日付により、ドキュメントは現在の状況を正確に反映し、ユーザーが最新の手順や情報に基づいて操作を行えるようにします。このような更新は、技術文書が信頼できるものであるために重要であり、利用者にとっても常に価値のある情報を提供することにつながります。
articles/search/search-manage-powershell.md
Diff
@@ -9,7 +9,7 @@ ms.author: heidist
ms.service: azure-ai-search
ms.devlang: powershell
ms.topic: how-to
-ms.date: 04/05/2024
+ms.date: 12/10/2024
ms.custom:
- devx-track-azurepowershell
- ignite-2023
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-manage-powershell.md
ファイルにおいて、日付フィールド「ms.date」を2024年4月5日から2024年12月10日に更新するものです。この日付の変更は、Azure PowerShellを使用してAzure AI Searchサービスを管理するための情報に対して、新しい日時を反映させることを目的としています。
更新により、ユーザーはより新しい内容と手順に基づいて作業できるようになります。このような日付の更新は、ドキュメントの信頼性を確保し、利用者に対し最新の情報を提供するために重要です。
articles/search/search-manage-rest.md
Diff
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 03/13/2024
+ms.date: 12/10/2024
---
# Manage your Azure AI Search service with REST APIs
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-manage-rest.md
ファイルにおいて、日付フィールド「ms.date」を2024年3月13日から2024年12月10日に更新するものです。この更新は、REST APIを使用してAzure AI Searchサービスを管理する際の最新の日付を文書内に反映させることを目的としています。
日付の変更により、ドキュメントが最新の情報を提供し、ユーザーが正確な手順を踏むことができるようになります。このような更新は、技術文書の信頼性を向上させ、利用者が常に新しい情報にアクセスできるようにするために重要です。
articles/search/search-manage.md
Diff
@@ -8,7 +8,7 @@ author: HeidiSteen
ms.author: heidist
ms.service: azure-ai-search
ms.topic: conceptual
-ms.date: 06/18/2024
+ms.date: 12/10/2024
---
# Service administration for Azure AI Search in the Azure portal
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-manage.md
ファイルにおいて、日付フィールド「ms.date」を2024年6月18日から2024年12月10日に更新するものです。この日付の変更は、AzureポータルでのAzure AI Searchサービスの管理に関する情報が最新であることを反映させるためのものです。
更新された日付により、ユーザーはより新しい手順や情報にアクセスでき、信頼性の高い技術文書となります。このような文書の更新は、ユーザーが常に最新の情報を得られるようにするために重要です。
articles/search/search-modeling-multitenant-saas-applications.md
Diff
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 04/23/2024
+ms.date: 12/10/2024
---
# Design patterns for multitenant SaaS applications and Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-modeling-multitenant-saas-applications.md
ファイルにおいて、日付フィールド「ms.date」を2024年4月23日から2024年12月10日に更新するものです。この更新は、マルチテナントSaaSアプリケーションとAzure AI Searchのデザインパターンに関する文書の最新性を保つために行われました。
日付の変更により、ドキュメントはユーザーにとって新しい情報を反映し、信頼して利用できる内容となります。こうした文書更新は、技術的な内容が常に最新であることを保証し、ユーザーが効率的に情報を得られるようにするために重要です。
articles/search/search-monitor-logs-powerbi.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 04/24/2024
+ms.date: 12/10/2024
---
# Visualize Azure AI Search Logs and Metrics with Power BI
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-monitor-logs-powerbi.md
ファイルにおいて、日付フィールド「ms.date」を2024年4月24日から2024年12月10日に更新するものです。この文書は、Azure AI SearchのログやメトリクスをPower BIで視覚化する方法に関するコンテンツを提供しています。
日付の更新は、この情報が最新であることを確認し、ユーザーがアクセスするデータを信頼性のあるものにするために重要です。文書を最新化することで、技術的な観点からの理解や実装がスムーズに行えるようになり、利用者にとって価値のあるリソースとなります。
articles/search/search-more-like-this.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: reference
-ms.date: 02/16/2024
+ms.date: 12/10/2024
---
# moreLikeThis (preview) in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-more-like-this.md
ファイルにおいて、日付フィールド「ms.date」を2024年2月16日から2024年12月10日に更新するものです。この文書は、Azure AI Searchにおける「moreLikeThis (プレビュー)」機能について説明しています。
日付の更新は、文書が最新の情報を反映することを保証し、利用者がこの機能に関する正確で信頼性のある情報を得るために重要です。常に最新のコンテンツを提供することで、ユーザーは新しい機能や使用方法を効果的に理解し、活用できるようになります。
articles/search/search-normalizers.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: how-to
-ms.date: 01/11/2024
+ms.date: 12/10/2024
---
# Text normalization for case-insensitive filtering, faceting and sorting
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-normalizers.md
ファイルにおいて、日付フィールド「ms.date」を2024年1月11日から2024年12月10日に更新するものです。この文書は、ケースインセンシティブなフィルタリング、ファセット、ソートのためのテキスト正規化についての方法を説明しています。
日付の更新は、文書が最新の情報を提供することを確保し、利用者がテキスト正規化の手法について正確で信頼性のある情報を入手できるようにするために重要です。常に新しい情報を提供することで、ユーザーはAzure AIの機能をより効果的に利用し、実装を行う際の参考にすることができます。
articles/search/search-pagination-page-layout.md
Diff
@@ -13,13 +13,9 @@ ms.topic: how-to
ms.date: 12/09/2024
---
-# Shape search results or modify search results composition
+# Shape search results or modify search results composition in Azure AI Search
-This article explains search results composition in Azure AI Search and how to work with results in your apps. Search results are returned in a query response. The structure of a response is determined by parameters in the query itself.
-
-Search results include top-level fields such as count and optional semantic ranking-related elements such as `answers`, but most of the response consists of matching documents in a values array.
-
-For search results composition, parameters on the query determine:
+This article explains search results composition and how to shape search results to fit your scenarios. Search results are returned in a query response. The shape of a response is determined by parameters in the query itself. These parameters include:
+ Number of matches found in the index (`count`)
+ Number of matches returned in the response (50 by default, configurable through `top`) or per page (`skip` and `top`)
@@ -29,6 +25,8 @@ For search results composition, parameters on the query determine:
+ Highlighting of terms within a result, matching on either the whole or partial term in the body
+ Optional elements from the semantic ranker (`answers` at the top, `captions` for each match)
+Search results can include top-level fields, but most of the response consists of matching documents in an array.
+
## Clients and APIs for defining the query response
You can use the following clients to configure a query response:
@@ -67,7 +65,7 @@ Occasionally, query output isn't what you're expecting to see. For example, you
## Counting matches
-The count parameter returns the number of documents in the index that are considered a match for the query. To return the count, add `count=true` to the query request. There's no maximum value imposed by the search service. Depending on your query and the content of your documents, the count could be as high as every document in the index.
+The `count` parameter returns the number of documents in the index that are considered a match for the query. To return the count, add `count=true` to the query request. There's no maximum value imposed by the search service. Depending on your query and the content of your documents, the count could be as high as every document in the index.
Count is accurate when the index is stable. If the system is actively adding, updating, or deleting documents, the count is approximate, excluding any documents that aren't fully indexed.
@@ -82,17 +80,15 @@ Count won't be affected by routine maintenance or other workloads on the search
## Number of results in the response
-Azure AI Search uses server-side paging to prevent queries from retrieving too many documents at once. Query parameters that determine the number of results in a response are `top` and `skip`. `top` refers to the number of search results in a page.
-
-The default page size is 50, while the maximum page size is 1,000. If you specify a value greater than 1,000 and there are more than 1,000 results found in your index, only the first 1,000 results are returned.
+Azure AI Search uses server-side paging to prevent queries from retrieving too many documents at once. Query parameters that determine the number of results in a response are `top` and `skip`. `top` refers to the number of search results in a page. `skip` is an interval of `top`, and it tells the search engine how many results to skip before getting the next set.
-If the number of matches exceed the page size, the response includes information to retrieve the next page of results. For example:
+The default page size is 50, while the maximum page size is 1,000. If you specify a value greater than 1,000 and there are more than 1,000 results found in your index, only the first 1,000 results are returned. If the number of matches exceed the page size, the response includes information to retrieve the next page of results. For example:
```json
"@odata.nextLink": "https://contoso-search-eastus.search.windows.net/indexes/realestate-us-sample-index/docs/search?api-version=2024-07-01"
```
-The top 50 are determined by search score, assuming the query is full text search or semantic. Otherwise, the top 50 are an arbitrary order for exact match queries (where uniform `@search.score=1.0` indicates arbitrary ranking).
+The top matches are determined by search score, assuming the query is full text search or semantic. Otherwise, the top matches are an arbitrary order for exact match queries (where uniform `@search.score=1.0` indicates arbitrary ranking).
Set `top` to override the default of 50. In newer preview APIs, if you're using a hybrid query, you can [specify maxTextRecallSize](hybrid-search-how-to-query.md#set-maxtextrecallsize-and-countandfacetmode-preview) to return up to 10,000 documents.
@@ -109,7 +105,7 @@ POST https://contoso-search-eastus.search.windows.net/indexes/realestate-us-samp
}
```
-To return the second set, skip the first 15 to get the next 15:
+This query returns the second set, skipping the first 15 to get the next 15 (16 through 30):
```http
POST https://contoso-search-eastus.search.windows.net/indexes/realestate-us-sample-index/docs/search?api-version=2024-07-01
Summary
{
"modification_type": "minor update",
"modification_title": "内容の改訂と拡充"
}
Explanation
この変更は、search-pagination-page-layout.md
ファイルに多くの文言の改訂と拡充を含んでいます。具体的には、記事のタイトルが「Azure AI Searchにおける検索結果の構成と調整」に変更され、検索結果の構成に関する説明がより詳細かつ明瞭になっています。
変更された部分では、検索結果がクエリの応答として返されること、その応答の形式がクエリ内のパラメータによって決まることの説明が強化されています。また、検索結果に含まれる主要なフィールドや、関連するパラメータの詳細な説明が追加され、具体的な内容(マッチ数やページネーションの説明など)も整理され、理解しやすくなっています。
これにより、ユーザーはAzure AI Searchの検索結果の処理についてより深く理解し、実装時に役立つ情報を得ることができます。全体的に、ユーザーが機能をより効果的に利用できるように情報が提供されています。
articles/search/search-performance-tips.md
Diff
@@ -6,7 +6,7 @@ author: mattgotteiner
ms.author: magottei
ms.service: azure-ai-search
ms.topic: conceptual
-ms.date: 06/06/2024
+ms.date: 12/10/2024
---
# Tips for better performance in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-performance-tips.md
ファイルにおいて、「ms.date」フィールドの日付を2024年6月6日から2024年12月10日に更新するものです。この文書は、Azure AI Searchにおけるパフォーマンスを向上させるためのヒントを提供しています。
日付の更新は、文書が最新の情報を反映していることを示し、ユーザーが時代に即したアドバイスを利用できるようにするために重要です。これにより、ユーザーはAzure AI Searchのパフォーマンスを最適化するための情報を常に新しい状態でアクセスできるようになります。
articles/search/search-query-overview.md
Diff
@@ -8,7 +8,7 @@ author: HeidiSteen
ms.author: heidist
ms.service: azure-ai-search
ms.topic: conceptual
-ms.date: 05/23/2024
+ms.date: 12/10/2024
---
# Querying in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-query-overview.md
ファイルにおいて、「ms.date」フィールドの日付を2024年5月23日から2024年12月10日に更新するものです。この文書は、Azure AI Searchにおけるクエリ処理に関する概要を提供しています。
日付の更新は、文書が最新の情報を反映していることを示し、読者が現行の機能やベストプラクティスに基づいた正確な情報を得られるようにするために重要です。これにより、Azure AI Searchの利用者は、効果的なクエリの構築に必要な最新の知識にアクセスできるようになります。
articles/search/search-query-troubleshoot-collection-filters.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 03/18/2024
+ms.date: 12/10/2024
---
# Troubleshooting OData collection filters in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-query-troubleshoot-collection-filters.md
ファイルにおいて、「ms.date」フィールドの日付を2024年3月18日から2024年12月10日に更新するものです。この文書は、Azure AI SearchにおけるODataコレクションフィルターのトラブルシューティングに関する情報を提供しています。
日付の更新は、文書が最新の情報を反映していることを示し、ユーザーが新しい機能や変更点を把握できるようにするために重要です。これにより、Azure AI Searchを利用する開発者やエンドユーザーは、トラブルシューティングにおける最新のアドバイスや技術を駆使して、問題を解決するための助けとなります。
articles/search/search-query-understand-collection-filters.md
Diff
@@ -9,7 +9,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 01/11/2024
+ms.date: 12/10/2024
---
# Understand how OData collection filters work in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-query-understand-collection-filters.md
ファイルにおいて、「ms.date」フィールドの日付を2024年1月11日から2024年12月10日に更新するものです。この文書は、Azure AI SearchにおけるODataコレクションフィルターの理解に関する情報を提供しています。
日付の更新は、文書が最新の情報を反映していることを示し、読者が新しい機能や改善点にアクセスできるようにするために重要です。この変更により、Azure AI Searchを使用するユーザーは、ODataコレクションフィルターの機能についての最新の理解を深め、適切に利用できるようになります。
articles/search/search-semi-structured-data.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: tutorial
-ms.date: 03/13/2024
+ms.date: 12/10/2024
---
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-semi-structured-data.md
ファイルにおいて、「ms.date」フィールドの日付を2024年3月13日から2024年12月10日に更新するものです。この文書は、Azure AI Searchにおける半構造化データの取り扱いに関するチュートリアルを提供しています。
日付の更新は、文書の内容が最新の情報を反映していることを示し、ユーザーが常に新しい機能や改善点に基づいた知識を持てるようにするために重要です。この変更により、Azure AI Searchを利用するユーザーは、半構造化データに関する新しい技術やアプローチを適切に学び、応用することができるようになります。
articles/search/search-sku-manage-costs.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 06/19/2024
+ms.date: 12/10/2024
---
# Plan and manage costs of an Azure AI Search service
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、search-sku-manage-costs.md
ファイルにおいて、ドキュメントの日付「ms.date」を2024年6月19日から2024年12月10日に更新するものです。この文書は、Azure AI Searchサービスのコストの計画と管理に関する情報を提供しています。
日付の更新は、ドキュメントが最新の情報を適切に反映していることを示し、ユーザーが新しい機能や変更点を把握できるよう支援します。この変更によって、Azure AI Searchを利用するユーザーは、コスト管理に関する最新のガイダンスを理解し、効果的にサービスを運用できるようになることを目指しています。
articles/search/search-what-is-azure-search.md
Diff
@@ -10,25 +10,25 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2024
ms.topic: overview
-ms.date: 10/27/2024
+ms.date: 12/10/2024
---
# What's Azure AI Search?
-Azure AI Search ([formerly known as "Azure Cognitive Search"](whats-new.md#new-service-name)) is an enterprise-ready search and retrieval system, with a comprehensive set of advanced search technologies, built for high-performance applications at any scale.
+Azure AI Search ([formerly known as "Azure Cognitive Search"](whats-new.md#new-service-name)) is an enterprise-ready information retrieval system for your heterogeneous content that you ingest into a search index. It comes with a comprehensive set of advanced search technologies, built for high-performance applications at any scale.
Azure AI Search is the recommended retrieval system for building RAG-based applications on Azure, with native LLM integrations between Azure OpenAI Service and Azure Machine Learning, and multiple strategies for relevance tuning.
-Azure AI Search can be used in both traditional and GenAI scenarios. Common use cases include knowledge base insights (catalog or document search), information discovery (data exploration), retrieval-augmented generation (RAG), and indexing automation.
+Azure AI Search can be used in both traditional and GenAI scenarios. Common use cases include catalog or document search, information discovery (data exploration), and retrieval-augmented generation (RAG) for conversational search.
When you create a search service, you work with the following capabilities:
-+ A search engine for [vector search](vector-search-overview.md) and [full text](search-lucene-query-architecture.md) and [hybrid search](hybrid-search-overview.md) over a search index
-+ Rich indexing with [integrated data chunking and vectorization](vector-search-integrated-vectorization.md), [lexical analysis](search-analyzers.md) for text, and [optional applied AI](cognitive-search-concept-intro.md) for content extraction and transformation
-+ Rich query syntax for [vector queries](vector-search-how-to-query.md), text search, [hybrid queries](hybrid-search-how-to-query.md), fuzzy search, autocomplete, geo-search and others
-+ Relevance and query performance tuning with [semantic ranking](semantic-search-overview.md), [scoring profiles](index-add-scoring-profiles.md), [quantization for vector queries](vector-search-how-to-quantization.md), and parameters for controlling query behaviors at runtime
-+ Azure scale, security, and reach
-+ Azure integration at the data layer, machine learning layer, Azure AI services and Azure OpenAI
++ A search engine for [vector search](vector-search-overview.md) and [full text](search-lucene-query-architecture.md) and [hybrid search](hybrid-search-overview.md) over a search index.
++ Rich indexing with the ability to content transformation. This includes [integrated data chunking and vectorization](vector-search-integrated-vectorization.md) for RAG, [lexical analysis](search-analyzers.md) for text, and [optional applied AI](cognitive-search-concept-intro.md) for content extraction and enrichment.
++ Rich query syntax for [vector queries](vector-search-how-to-query.md), text search, [hybrid queries](hybrid-search-how-to-query.md), fuzzy search, autocomplete, geo-search and others.
++ Relevance and query performance tuning with [semantic ranking](semantic-search-overview.md), [scoring profiles](index-add-scoring-profiles.md), [quantization for vector queries](vector-search-how-to-quantization.md), and parameters for controlling query behaviors at runtime.
++ Azure scale, security, and reach.
++ Azure integration at the data layer, machine learning layer, Azure AI services and Azure OpenAI.
> [!div class="nextstepaction"]
> [Create a search service](search-create-service-portal.md)
@@ -47,7 +47,7 @@ On the search service itself, the two primary workloads are *indexing* and *quer
+ [**Indexing**](search-what-is-an-index.md) is an intake process that loads content into your search service and makes it searchable. Internally, inbound text is processed into tokens and stored in inverted indexes, and inbound vectors are stored in vector indexes. The document format that Azure AI Search can index is JSON. You can upload JSON documents that you've assembled, or use an indexer to retrieve and serialize your data into JSON.
- [Applied AI](cognitive-search-concept-intro.md) through a [skillset](cognitive-search-working-with-skillsets.md) extends indexing with image and language models. If you have images or large unstructured text in source document, you can attach skills that perform OCR, analyze and describe images, infer structure, translate text and more. Output is text that can be serialized into JSON and ingested into a search index.
+ [Applied AI](cognitive-search-concept-intro.md) through a [skillset](cognitive-search-working-with-skillsets.md) extends indexing with image and language models. If you have images or large unstructured text in source document, you can attach skills that perform OCR, analyze and describe images, infer structure, translate text, and more. Output is text that can be serialized into JSON and ingested into a search index.
Skillsets can also perform [data chunking and vectorization during indexing](vector-search-integrated-vectorization.md). Skills that attach to Azure OpenAI, the model catalog in Azure AI Foundry portal, or custom skills that attach to any external chunking and embedding model can be used during indexing to create vector data. Output is chunked vector content that can be ingested into a search index.
@@ -139,8 +139,8 @@ Customers often ask how Azure AI Search compares with other search-related solut
Key strengths include:
-+ Support for vector and nonvector (text) indexing and queries. With vector similarity search, you can find information that’s semantically similar to search queries, even if the search terms aren’t exact matches. Use hybrid search for the best of keyword and vector search.
-+ Ranking and relevance tuning through semantic ranking and scoring profiles. Query syntax supports term boosting and field prioritization.
++ Support for vector and nonvector (text) indexing and queries. With vector similarity search, you can find information that’s semantically similar to search queries, even if the search terms aren’t exact matches. Use hybrid search to combine the strengths of keyword and vector search.
++ Ranking and relevance tuning through semantic ranking and scoring profiles. You can also leverage query syntax that supports term boosting and field prioritization.
+ Azure data integration (crawlers) at the indexing layer.
+ Azure AI integration for transformations that make content text and vector searchable.
+ Microsoft Entra security for trusted connections, and Azure Private Link for private connections in no-internet scenarios.
Summary
{
"modification_type": "minor update",
"modification_title": "コンテンツの明確化と日付の更新"
}
Explanation
この変更は、search-what-is-azure-search.md
ファイルにおいて、Azure AI Searchに関する説明の内容を明確化し、日付「ms.date」を2024年10月27日から2024年12月10日に更新するものです。具体的には、情報検索システムの説明がより具体的な表現に変更され、いくつかの機能とユースケースの説明が簡潔に修正されています。
特に、Azure AI Searchが情報を検索インデックスに取り込むためのシステムであることを強調し、従来のシナリオおよび生成AI(GenAI)シナリオの両方で利用可能であることを再確認しています。また、機能説明がより体系的に整理されており、内容の統一感が増しています。
この変更により、ユーザーはAzure AI Searchの機能と利点をより理解しやすくなり、サービスの利用において価値を最大限に引き出す手助けとなることを目的としています。
articles/search/security-controls-policy.md
Diff
@@ -2,7 +2,7 @@
title: Azure Policy Regulatory Compliance controls for Azure AI Search
description: Lists Azure Policy Regulatory Compliance controls available for Azure AI Search. These built-in policy definitions provide common approaches to managing the compliance of your Azure resources.
ms.date: 02/06/2024
-ms.topic: sample
+ms.topic: reference
author: HeidiSteen
ms.author: heidist
ms.service: azure-ai-search
Summary
{
"modification_type": "minor update",
"modification_title": "トピックの種類の変更"
}
Explanation
この変更は、security-controls-policy.md
ファイルにおいて、トピックの種類を「sample」から「reference」に変更するものです。この修正により、ドキュメントがより適切なカテゴリに分類され、利用者にとっての情報の明確さが向上します。
具体的には、この文書はAzure AI Searchに関連するAzure Policyの規制遵守 controls に関する情報を提供しており、ユーザーがリソースのコンプライアンスを管理するための一般的なアプローチを理解できることを目的としています。トピックの変更によって、読者がこの内容を参照資料として捉えることができるようになり、より効果的に利用しやすくなります。
articles/search/semantic-answers.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 02/08/2024
+ms.date: 12/10/2024
---
# Return a semantic answer in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、semantic-answers.md
ファイルにおいて、日付「ms.date」を2024年2月8日から2024年12月10日に更新するものです。この更新により、ドキュメントの内容が最新の情報を反映していることを示しています。
具体的には、このドキュメントはAzure AI Searchにおけるセマンティック回答を返す方法に関する情報を提供しており、日付の変更はコンテンツの有効性を高め、読者にとっての信頼性を向上させる目的があります。最新の日付を反映させることで、ユーザーは最新の機能や最善の実践方法に基づいた情報を得ることができるようになります。
articles/search/speller-how-to-add.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 06/25/2024
+ms.date: 12/10/2024
---
# Add spell check to queries in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、speller-how-to-add.md
ファイルにおいて、日付「ms.date」を2024年6月25日から2024年12月10日に更新するものです。この修正は、ドキュメントの内容が最新の情報を反映するようにするためのものです。
具体的には、この文書はAzure AI Searchにおけるクエリへのスペルチェックの追加方法についての情報を提供しており、日付の更新により、リーダーに対して内容の新鮮さと信頼性を向上させる効果があります。最新の日付を示すことで、ユーザーが新しい機能や実装方法に基づいて最適な情報を得られるようにすることを目的としています。
articles/search/toc.yml
Diff
@@ -414,7 +414,7 @@ items:
href: search-normalizers.md
- name: Search results
items:
- - name: Paging, sorting, and formatting
+ - name: Page, sort, and shape results
href: search-pagination-page-layout.md
- name: Return a semantic answer
href: semantic-answers.md
Summary
{
"modification_type": "minor update",
"modification_title": "項目名の更新"
}
Explanation
この変更は、toc.yml
ファイルにおいて、「Paging, sorting, and formatting」という項目名を「Page, sort, and shape results」に変更するものです。この修正は、文書内の情報をより明確にすることを目的としています。
具体的には、検索結果に関するセクションにおいて、ユーザーに対してより直感的で分かりやすいタイトルを提供することで、ドキュメントのナビゲーション体験を向上させています。新しい項目名は、ページング、ソート、およびフォーマッティングに関連する機能を示す表現として、より適切であると考えられます。これにより、ユーザーは目的の情報により簡単にアクセスできるようになることが期待されます。
articles/search/troubleshoot-shared-private-link-resources.md
Diff
@@ -10,7 +10,7 @@ ms.service: azure-ai-search
ms.custom:
- ignite-2023
ms.topic: conceptual
-ms.date: 02/20/2024
+ms.date: 12/10/2024
---
# Troubleshoot issues with Shared Private Links in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、troubleshoot-shared-private-link-resources.md
ファイルにおいて、日付「ms.date」を2024年2月20日から2024年12月10日に変更するものです。この修正は、ドキュメントが最新の情報を反映するようにするためのものです。
具体的には、この文書はAzure AI Searchにおける共有プライベートリンクのトラブルシューティングに関する情報を提供しており、日付の更新により、ユーザーが最新の問題解決手法や関連情報に基づいて対処できるようにしています。最新の日付を示すことで、リーダーに信頼できる情報を提供し、ドキュメントの有用性を向上させることを目的としています。
articles/search/tutorial-multiple-data-sources.md
Diff
@@ -8,7 +8,7 @@ author: HeidiSteen
ms.author: heidist
ms.service: azure-ai-search
ms.topic: tutorial
-ms.date: 01/17/2024
+ms.date: 12/10/2024
ms.custom:
- devx-track-csharp
- devx-track-dotnet
Summary
{
"modification_type": "minor update",
"modification_title": "日付の更新"
}
Explanation
この変更は、tutorial-multiple-data-sources.md
ファイルにおいて、日付「ms.date」を2024年1月17日から2024年12月10日に更新するものです。この修正は、チュートリアルが最新の情報を反映するためのものです。
具体的には、Azure AI Searchに関する複数のデータソースを利用するチュートリアルに対して、現在の日付が更新されることで、ユーザーは最新の手法や技術を基に学習できるようになります。日付を最新のものに保つことで、文書の信頼性と関連性を維持し、読み手が実践的かつ具体的な情報を得られるようにすることを意図しています。