Naming rules (Azure Cognitive Search)
This section explains the naming rules for Azure Cognitive Search services, indexes, fields, document keys, scoring profiles, suggesters, synonym maps, indexers, data sources, and skillsets.
Chart of naming rules
You'll notice that the conventions in the following table are not consistent down the line for all objects. This is because objects are used in different contexts, where the naming rules of other standards are imposed on specific Azure Cognitive Search objects. URLs, JSON, and DNS all have different conventions in terms of case-sensitivity, special characters, and character placement. By necessity, objects referenced in a URL (host name, path, or query string) or JSON request body have to follow the naming conventions of the applicable standard, thus accounting for the variation you see below.
| Name | Length | Case | Allowable characters | Character placement | Example |
|---|---|---|---|---|---|
| Service | 2 - 60 | Lower | Letters, numbers, dashes ("-") | First, second, and last characters must be a letter or number. No consecutive dashes. |
contoso-srch1 |
| Index | 2 - 128 | Lower | Letters, numbers, dashes ("-") | First character must be a letter or number. No consecutive dashes. |
idx-hotels-2015 |
| Field | 1 -128 | Upper or lower | Letters, numbers, underscores ("_") | First character must be a letter. The name cannot begin with "azureSearch". |
Store_Name |
| Document key | 1024 | Upper or lower | Letters, numbers, dashes ("-"), underscores ("_"), equal signs ("=") For compound keys, we recommend using a dash, underscore, or equal sign as a separator. If keys contain characters other than the above, we recommend encoding them using a URL-safe variant of Base64. For example, in .NET you can use the HttpServerUtility.UrlTokenEncode method for this purpose. |
First character cannot be an underscore. | RXhhbXBsZSBkb2N1bWVudCBrZXk= This is the string “Example document key” encoded in base 64. URL-safe Base64 encoding is recommended because document keys are sometimes used in the URL path. Encoding allows you to use characters in a document key that would otherwise be problematic in a URL. |
| Scoring profile | 1 - 128 | Upper or lower | Letters, numbers, underscores ("_") | First character must be a letter or number. | BoostFunc_TagsCustHist |
| Suggester | 1 - 128 | Upper or lower | Letters, numbers, underscores ("_") | First character must be a letter or number. | Sugst01_Apparel |
| Data source | 1 - 128 | Lower | Letters, numbers, dashes ("-") | First and last character must be a letter or number. | docdbds-onlinecatalog-20150228 |
| Indexer | 1 -128 | Lower | Letters, numbers, dashes ("-") | First and last character must be a letter or number. | docbindxr-onlinecatalog-20150228 |
| Synonym map | 1 -128 | Lower | Letters, numbers, dashes ("-") | First and last character must be a letter or number. | custom-synonyms-15 |
| Skillset | 1 -128 | Lower | Letters, numbers, dashes ("-") | First and last character must be a letter or number. | grok-myfiles-skillset-1 |