次の方法で共有


名前付け規則 (Azure AI Search)

このセクションでは、Azure AI Search の名前付け規則について説明します。

名前付け規則のグラフ

規則は、オブジェクトの使用方法によってオブジェクトによって異なります。 他の標準の名前付け規則は、特定の Azure AI Search オブジェクトに適用されます。 URL と JSON には、大文字と小文字の区別、特殊文字、および文字の配置に関して異なる規則があります。 必要に応じて、URL (ホスト名、パス、またはクエリ文字列) または JSON 要求本文で参照されるオブジェクトは、該当する標準の名前付け規則に従う必要があります。

名前 長さ ケース 許容される文字 文字の配置
サービス 2 - 60 文字、数字、ダッシュ (-) 最初、2 番目、および最後の文字は、文字または数字である必要があります。

連続するダッシュはどこにもありません。
contoso-srch1
インデックス 2 - 128 文字、数字、ダッシュ (-)、アンダースコア (_) 最初の文字は文字または数字にする必要があります。

連続するダッシュまたはアンダースコアなし
idx-hotels-2024
フィールド 1 -128 大文字または小文字 文字、数字、アンダースコア (_) 最初の文字は文字にする必要があります。

名前を "azureSearch" で始めることはできません。
Store_Name
ドキュメント キー 1024 大文字または小文字 文字、数字、ダッシュ (-)、アンダースコア (_)、等号 (=)

複合キーの場合は、ダッシュ、アンダースコア、または等号を区切り記号として使用することをお勧めします。

キーに他のシンボルが含まれている場合は、Base64 の URL セーフなバリアントを使用してエンコードすることをお勧めします。 たとえば、.NET では、この目的のために HttpServerUtility.UrlTokenEncode メソッドを使用できます。
最初の文字をアンダースコアにすることはできません。 RXhhbXBsZSBkb2N1bWVudCBrZXk=

base 64 でエンコードされた文字列 "Example document key" です。 ドキュメント キーは URL パスで使用される場合があるため、URL セーフな Base64 エンコードをお勧めします。 エンコードにより、URL で問題になるドキュメント キーの文字を使用できるようになります。
スコアリング プロファイル 1 - 128 大文字または小文字 文字、数字、アンダースコア (_) 最初の文字は文字または数字にする必要があります。 BoostFunc_TagsCustHist
サジェスター 1 - 128 大文字または小文字 文字、数字、アンダースコア (_) 最初の文字は文字または数字にする必要があります。 Sugst01_Apparel
データ ソース 1 - 128 文字、数字、ダッシュ (-) 最初と最後の文字は文字または数字にする必要があります。 docdbds-onlinecatalog-20240228
Indexer 1 -128 文字、数字、ダッシュ (-) 最初と最後の文字は文字または数字にする必要があります。 docbindxr-onlinecatalog-20240228
シノニム マップ 1 -128 文字、数字、ダッシュ (-) 最初と最後の文字は文字または数字にする必要があります。 custom-synonyms-2024
スキルセット 1 -128 文字、数字、ダッシュ (-) 最初と最後の文字は文字または数字にする必要があります。 grok-myfiles-skillset-1

こちらもご覧ください