Reguły nazewnictwa (Azure AI Search)

  • Artykuł

W tej sekcji opisano reguły nazewnictwa 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 dane JSON mają różne konwencje pod względem uwzględniania 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.

Nazwa Długość Sprawa Dozwolone znaki Umieszczanie znaków Przykład
Usługa 2 - 60 Niższa Litery, cyfry, kreski (-) Pierwsze, drugie i ostatnie znaki muszą być literą lub cyfrą.

Nie ma kolejnych kresek w dowolnym miejscu.		 contoso-srch1
Indeks 2 - 128 Niższa Litery, cyfry, kreski (-), podkreślenia (_) Pierwszy znak musi być literą lub cyfrą.

Brak kolejnych kresek ani podkreśleń		 idx-hotels-2024
Pole 1 -128 Górna lub dolna Litery, cyfry, podkreślenia (_) Pierwszy znak musi być literą.

Nazwa nie może zaczynać się od ciągu "azureSearch".		 Store_Name
Klucz dokumentu 1024 Górna lub dolna Litery, cyfry, kreski (-), podkreślenia (_), znaki równości (=)

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

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

Ciąg "Przykładowy klucz dokumentu" zakodowany w bazie 64. Zalecane jest bezpieczne kodowanie Base64, ponieważ klucze dokumentów są czasami używane w ścieżce adresu URL. Kodowanie umożliwia używanie znaków w kluczu dokumentu, które w przeciwnym razie byłyby problematyczne w adresie URL.
Profil oceniania 1 - 128 Górna lub dolna Litery, cyfry, podkreślenia (_) Pierwszy znak musi być literą lub cyfrą. BoostFunc_TagsCustHist
Sugestor 1 - 128 Górna lub dolna Litery, cyfry, podkreślenia (_) Pierwszy znak musi być literą lub cyfrą. Sugst01_Apparel
Źródło danych 1 - 128 Niższa Litery, cyfry, kreski (-) Pierwszy i ostatni znak musi być literą lub cyfrą. docdbds-onlinecatalog-20240228
Indeksator 1 -128 Niższa Litery, cyfry, kreski (-) Pierwszy i ostatni znak musi być literą lub cyfrą. docbindxr-onlinecatalog-20240228
Mapa synonimów 1 -128 Niższa Litery, cyfry, kreski (-) Pierwszy i ostatni znak musi być literą lub cyfrą. custom-synonimy-2024
Skillset 1 -128 Niższa Litery, cyfry, kreski (-) Pierwszy i ostatni znak musi być literą lub cyfrą. grok-myfiles-skillset-1

Zobacz też