Правила именования (поиск ИИ Azure)
В этом разделе описываются правила именования для поиска ИИ Azure.
Диаграмма правил именования
Соглашения зависят от того, как используются объекты. Правила именования других стандартов применяются к определенным объектам поиска ИИ Azure. URL-адреса и JSON имеют разные соглашения с точки зрения учета регистра, специальных символов и размещения символов. По необходимости объекты, на которые ссылается URL-адрес (имя узла, путь или строка запроса) или текст запроса JSON, должны соответствовать соглашениям об именовании применимого стандарта.
| Имя | Длина | Случай | Допустимые символы | Размещение символов | Пример |
|---|---|---|---|---|---|
| Служба | 2 - 60 | Ниже | Буквы, цифры, дефисы (-) |
Первый, второй и последний символы должны быть буквой или цифрой. Нигде нет последовательных дефисов. |
contoso-srch1 |
| Индекс | 2 - 128 | Ниже | Буквы, цифры, дефисы (-), символы подчеркивания (_) |
Первым символом должна быть буква или цифра. Нет последовательных дефисов или символов подчеркивания |
idx-hotels-2024 |
| Поле | 1 -128 | Верхний или нижний | Буквы, цифры, символы подчеркивания (_) |
Первым символом должна быть буква. Имя не может начинаться с azureSearch. |
Store_Name |
| Ключ документа | 1024 | Верхний или нижний | Буквы, цифры, дефисы (-), символы подчеркивания (_), знаки равенства (=)Для составных ключей рекомендуется использовать в качестве разделителя дефис, подчеркивание или знак равенства. Если ключи содержат другие символы, рекомендуется кодирование с помощью безопасного по URL-адресу варианта Base64. Например, в .NET для этой цели можно использовать метод HttpServerUtility.UrlTokenEncode . |
Первый символ не может быть символом подчеркивания. | RXhhbXBsZSBkb2N1bWVudCBrZXk= Строка "Пример ключа документа", закодированная в base 64. Рекомендуется использовать безопасное для URL-адреса кодировки Base64, так как ключи документов иногда используются в URL-пути. Кодирование позволяет использовать в ключе документа символы, которые в противном случае недопустимы для URL-адреса. |
| Профиль оценки | 1 - 128 | Верхний или нижний | Буквы, цифры, символы подчеркивания (_) |
Первым символом должна быть буква или цифра. | BoostFunc_TagsCustHist |
| Средство подбора | 1 - 128 | Верхний или нижний | Буквы, цифры, символы подчеркивания (_) |
Первым символом должна быть буква или цифра. | Sugst01_Apparel |
| Источник данных | 1 - 128 | Ниже | Буквы, цифры, дефисы (-) |
Первым и последним символом должны быть буквы или цифры. | docdbds-onlinecatalog-20240228 |
| Индексатор | 1 -128 | Ниже | Буквы, цифры, дефисы (-) |
Первым и последним символом должны быть буквы или цифры. | docbindxr-onlinecatalog-20240228 |
| Схема синонимов | 1 -128 | Ниже | Буквы, цифры, дефисы (-) |
Первым и последним символом должны быть буквы или цифры. | custom-synonyms-2024 |
| Набор навыков | 1 -128 | Ниже | Буквы, цифры, дефисы (-) |
Первым и последним символом должны быть буквы или цифры. | grok-myfiles-skillset-1 |