Namngivningsregler (Azure AI Search)

I det här avsnittet beskrivs namngivningsreglerna för Azure AI Search.

Diagram över namngivningsregler

Konventionerna varierar beroende på objekt på grund av hur objekt används. Namngivningsregler för andra standarder tillämpas på specifika Azure AI Search-objekt. URL:er och JSON har olika konventioner när det gäller skiftlägeskänslighet, specialtecken och teckenplacering. Av nödvändighet måste objekt som refereras i en URL (värdnamn, sökväg eller frågesträng) eller JSON-begärandetext följa namngivningskonventionerna för tillämplig standard.

Name Längd Ärende Tillåtna tecken Teckenplacering Exempel
Tjänst 2 - 60 Lägre Bokstäver, siffror, bindestreck (-) Första, andra och sista tecknen måste vara en bokstav eller ett tal.

Inga efterföljande bindestreck någonstans.
contoso-srch1
Index 2 - 128 Lägre Bokstäver, siffror, bindestreck (-), understreck (_) Det första tecknet måste vara en bokstav eller ett tal.

Inga efterföljande bindestreck eller understreck
idx-hotels-2024
Fält 1 -128 Övre eller nedre Bokstäver, siffror, understreck (_) Det första tecknet måste vara en bokstav.

Namnet kan inte börja med "azureSearch".
Store_Name
Dokumentnyckel 1024 Övre eller nedre Bokstäver, siffror, bindestreck (-), understreck (_), likhetstecken (=)

För sammansatta nycklar rekommenderar vi att du använder ett bindestreck, understreck eller likhetstecken som avgränsare.

Om nycklar innehåller andra symboler rekommenderar vi att du kodar dem med hjälp av en URL-säker variant av Base64. I .NET kan du till exempel använda metoden HttpServerUtility.UrlTokenEncode för det här ändamålet.
Det första tecknet får inte vara ett understreck. RXhhbXBsZSBkb2N1bWVudCBrZXk=

Strängen "Exempeldokumentnyckel" kodad i bas 64. URL-säker Base64-kodning rekommenderas eftersom dokumentnycklar ibland används i URL-sökvägen. Med kodning kan du använda tecken i en dokumentnyckel som annars skulle vara problematisk i en URL.
Bedömningsprofil 1 - 128 Övre eller nedre Bokstäver, siffror, understreck (_) Det första tecknet måste vara en bokstav eller ett tal. BoostFunc_TagsCustHist
Förslagsspelare 1 - 128 Övre eller nedre Bokstäver, siffror, understreck (_) Det första tecknet måste vara en bokstav eller ett tal. Sugst01_Apparel
Datakälla 1 - 128 Lägre Bokstäver, siffror, bindestreck (-) Det första och sista tecknet måste vara en bokstav eller ett tal. docdbds-onlinecatalog-20240228
Indexerare 1 -128 Lägre Bokstäver, siffror, bindestreck (-) Det första och sista tecknet måste vara en bokstav eller ett tal. docbindxr-onlinecatalog-20240228
Synonymkarta 1 -128 Lägre Bokstäver, siffror, bindestreck (-) Det första och sista tecknet måste vara en bokstav eller ett tal. custom-synonyms-2024
Skillset 1 -128 Lägre Bokstäver, siffror, bindestreck (-) Det första och sista tecknet måste vara en bokstav eller ett tal. grok-myfiles-skillset-1

Se även