利用上の注意

このポストは Microsoft 社の Azure 公式ドキュメント(CC BY 4.0 または MIT ライセンス) をもとに生成AIを用いて翻案・要約した派生作品です。元の文書は MicrosoftDocs/azure-ai-docs にホストされています。

生成AIの性能には限界があり、誤訳や誤解釈が含まれる可能性があります。本ポストはあくまで参考情報として用い、正確な情報は必ず元の文書を参照してください。

このポストで使用されている商標はそれぞれの所有者に帰属します。これらの商標は技術的な説明のために使用されており、商標権者からの公式な承認や推奨を示すものではありません。

View Diff on GitHub

ハイライト

この変更では、articles/search/search-normalizers.mdファイルに対して、検索ノーマライザーに関する新しいテスト機能の追加が行われました。これにより、ノーマライザーをHTTP POSTリクエストを用いてテストする具体的な方法が提供されています。また、文書の日付が更新され、細かな修正も加えられています。

新機能

ノーマライザーのテスト方法に関するセクションが追加されました。
実際のリクエストとレスポンス例が追加され、具体的な使用例が示されました。
asciifoldingノーマライザーを使用した場合の具体例が含まれています。

ブレイキングチェンジ

なし。

その他のアップデート

文書の日付が2025年9月28日から2025年10月1日に更新されました。

インサイト

このコード変更は、検索ノーマライザーを利用する開発者にとって、非常に有用なものとなっています。特に、新しく追加されたテストセクションは、ノーマライザーが入力をどのように処理するかを開発者がより容易に理解できるように設計されています。HTTP POSTリクエストを利用したノーマライザーの挙動の確認方法は、検索関連のアプリケーションの開発やデバッグにおいて非常に役立つでしょう。

asciifoldingノーマライザーの具体的な例が含まれていることで、文字の正規化の詳細な動作を視覚化でき、エンジニアはそれを基に複雑な検索機能を構築する際の活用方法を学ぶことができます。全体として、この更新はノーマライザーのドキュメントがより包括的になり、ユーザーエクスペリエンスの向上を目的としているといえます。

Summary Table

Filename	Type	Title	Status	A	D	M
search-normalizers.md	minor update	検索ノーマライザーに新しいテスト機能を追加	modified	35	1	36

Modified Contents

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: 09/28/2025
+ms.date: 10/01/2025
 ms.update-cycle: 365-days
 ---
 
@@ -90,6 +90,40 @@ Azure AI Search provides built-in normalizers for common use-cases along with th
 
 <sup>(1)</sup> Custom normalizers don't specify tokenizers since normalizers always produce a single token.
 
+## Test a normalizer
+
+You can use the [Test Analyzer (REST)](/rest/api/searchservice/indexes/analyze) to see how a normalizer processes an input.
+
+**Request**
+
+```http
+  POST https://[search service name].search.windows.net/indexes/[index name]/analyze?api-version=[api-version]
+    Content-Type: application/json
+    api-key: [admin key]
+
+  {
+     "normalizer":"asciifolding",
+     "text": "Vis-à-vis means Opposite"
+  }
+```
+
+**Response**
+
+```http
+HTTP/1.1 200 OK
+
+{
+  "tokens": [
+    {
+      "token": "Vis-a-vis means Opposite",
+      "startOffset": 0,
+      "endOffset": 24,
+      "position": 0
+    }
+  ]
+}
+```
+
 ## Normalizers reference
 
 ### Predefined normalizers

Summary

{
    "modification_type": "minor update",
    "modification_title": "検索ノーマライザーに新しいテスト機能を追加"
}

Explanation

この変更は、articles/search/search-normalizers.mdファイルに関連するもので、検索ノーマライザーのドキュメントに新しいテスト機能を追加する内容です。具体的には、ノーマライザーをテストする方法についてのセクションが新たに追加され、HTTP POSTリクエストを使ってノーマライザーがどのように入力を処理するかを示しています。この修正には、リクエストとレスポンスの例が含まれており、特にasciifoldingノーマライザーを使用した場合の入力と出力が具体的に記載されています。

また、文書の日付も2025年9月28日から2025年10月1日に更新されており、その他の細かな修正が行われています。この変更によって、ユーザーはノーマライザーのテストをより容易に行い、その挙動を理解することができるようになります。全体として、このアップデートは検索機能の強化に寄与するものです。

Diff Insight Report - search