Reguły nazewnictwa (Azure Cognitive Search)

W tej sekcji opisano reguły nazewnictwa usług Azure Cognitive Search, indeksów, pól, kluczy dokumentów, profilów oceniania, sugestorów, map synonimów, indeksatorów, źródeł danych i zestawów umiejętności.

Wykres reguł nazewnictwa

Zauważysz, że konwencje w poniższej tabeli nie są spójne w dół wiersza dla wszystkich obiektów. Dzieje się tak, ponieważ obiekty są używane w różnych kontekstach, w których reguły nazewnictwa innych standardów są nakładane na określone obiekty Azure Cognitive Search. Adresy URL, JSON i DNS mają różne konwencje w zakresie poufności liter, znaków specjalnych i umieszczania znaków. W razie potrzeby 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, co oznacza różnice widoczne poniżej.

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ą.

Brak kolejnych kresków.
contoso-srch1
Indeks 2 - 128 Niższa Litery, cyfry, kreski ("-") Pierwszy znak musi być literą lub cyfrą.

Brak kolejnych kresków.
idx-hotels-2015
Pole 1 -128 Górna lub dolna Litery, cyfry, podkreślenia ("_") Pierwszy znak musi być literą.

Nazwa nie może zaczynać się od "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ą znaki inne niż powyższe, zalecamy kodowanie ich przy użyciu bezpiecznego pod adresem 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ć znakiem podkreślenia. RXhhbXBsZSBkb2N1bWVudCBrZXk=

Jest to 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-20150228
Indeksator 1 -128 Niższa Litery, cyfry, kreski ("-") Pierwszy i ostatni znak musi być literą lub cyfrą. docbindxr-onlinecatalog-20150228
Mapa synonimów 1 -128 Niższa Litery, cyfry, kreski ("-") Pierwszy i ostatni znak musi być literą lub cyfrą. custom-synonyms-15
Skillset 1 -128 Niższa Litery, cyfry, kreski ("-") Pierwszy i ostatni znak musi być literą lub cyfrą. grok-myfiles-skillset-1

Zobacz też