Udostępnij przez


Reguły nazewnictwa (Azure AI Search)

W tej sekcji wyjaśniono reguły nazewnictwa dla usługi Azure AI Search.

Wykres reguł nazewnictwa

Konwencje różnią się w zależności od obiektu ze względu na sposób użycia obiektów. Reguły nazewnictwa innych standardów są nakładane na określone obiekty usługi Azure AI Search. Adresy URL i JSON mają różne konwencje pod względem rozróżniania wielkości liter, znaków specjalnych i umieszczania znaków. Z konieczności obiekty, do których odwołuje się adres URL (nazwa hosta, ścieżka lub ciąg zapytania) lub treść żądania JSON, muszą być zgodne z konwencjami nazewnictwa odpowiedniego standardu.

Name Długość Przypadek Dopuszczalne znaki Rozmieszczenie postaci Example
Usługa 2 - 60 Obniżyć Litery, cyfry, myślniki (-) Pierwszy, drugi i ostatni znak musi być literą lub cyfrą.

Nigdzie nie ma kolejnych kresek.
contoso-srch1
Index 2 - 128 Obniżyć Litery, cyfry, myślniki (-), podkreślenia (_) Pierwszy znak musi być literą lub cyfrą.

Brak następujących po sobie myślników i podkreśleń
idx-hotele-2024
(No changes needed) 1 -128 Górny lub dolny Litery, cyfry, podkreślenia (_) Pierwszy znak musi być literą.

Nazwa nie może zaczynać się od "azureSearch".
Store_Name
Klucz dokumentu 1024 Górny lub dolny Litery, cyfry, myślniki (-), podkreślenia (),_ znaki równości (=)

W przypadku kluczy złożonych zalecamy użycie łącznika, podkreślenia lub znaku równości jako separatora.

Jeśli klucze zawierają inne symbole, zalecamy zakodowanie ich przy użyciu bezpiecznego dla adresów URL wariantu Base64. Na przykład na platformie .NET można w tym celu użyć metody HttpServerUtility.UrlTokenEncode .
Pierwszy znak nie może być podkreśleniem. RXhhbXBsZSBkb2N1bWVudCBrZXk=

Ciąg "Przykładowy klucz dokumentu" zakodowany w podstawie 64. Kodowanie Base64 bezpieczne dla adresów URL jest zalecane, ponieważ klucze dokumentów są czasami używane w ścieżce adresu URL. Kodowanie umożliwia użycie znaków w kluczu dokumentu, które w przeciwnym razie byłyby problematyczne w adresie URL.
Profil punktacji 1 - 128 Górny lub dolny Litery, cyfry, podkreślenia (_) Pierwszy znak musi być literą lub cyfrą. BoostFunc_TagsCustHist
Sugestia 1 - 128 Górny lub dolny Litery, cyfry, podkreślenia (_) Pierwszy znak musi być literą lub cyfrą. Sugst01_Apparel
Źródło danych 1 - 128 Obniżyć Litery, cyfry, myślniki (-) Pierwszy i ostatni znak musi być literą lub cyfrą. docdbds-onlinecatalog-20240228
Indexer 1 -128 Obniżyć Litery, cyfry, myślniki (-) Pierwszy i ostatni znak musi być literą lub cyfrą. docbindxr-onlinecatalog-20240228
Mapa synonimów 1 -128 Obniżyć Litery, cyfry, myślniki (-) Pierwszy i ostatni znak musi być literą lub cyfrą. niestandardowe-synonimy-2024
Zestaw umiejętności 1 -128 Obniżyć Litery, cyfry, myślniki (-) Pierwszy i ostatni znak musi być literą lub cyfrą. grok-myfiles-skillset-1 powiedział:

Zobacz także