Поделиться через


Правила именования (поиск ИИ 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

См. также раздел