名前付け規則 (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 |