Reguły nazewnictwa (Azure AI Search)
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 |