Sdílet prostřednictvím


Pravidla pojmenování (Azure AI Search)

Tato část vysvětluje pravidla pojmenování pro Azure AI Search.

Tabulka pravidel pojmenování

Konvence se liší podle objektu v závislosti na způsobu použití objektů. Pravidla pojmenování jiných standardů jsou uložena pro konkrétní objekty Azure AI Search. Adresy URL a JSON mají různé konvence, pokud jde o rozlišování velkých a malých písmen, speciální znaky a umístění znaků. Objekty odkazované v adrese URL (název hostitele, cesta nebo řetězec dotazu) nebo v těle požadavku JSON musí nutně splňovat konvence pojmenování příslušného standardu.

Název Délka Případ Povolené znaky Umístění znaků Example
Service 2 - 60 Nižší Písmena, číslice, pomlčky (-) První, druhý a poslední znak musí být písmeno nebo číslo.

Nikde žádné po sobě jdoucí pomlčky.
contoso-srch1 – řekl:
Index 2 - 128 Nižší Písmena, číslice, pomlčky (-), podtržítka (_) První znak musí být písmeno nebo číslo.

Žádné po sobě jdoucí čárky nebo podtržítka
idx-hotely-2024 řekl:
Obor 1 -128 Horní nebo dolní Písmena, číslice, podtržítka (_) První znak musí být písmeno.

Název nesmí začínat na "azureSearch".
Store_Name
Klíč dokumentu 1024 Horní nebo dolní Písmena, číslice, pomlčky (-), podtržítka (_), znaménka rovná se (=)

U složených klíčů doporučujeme jako oddělovač použít pomlčku, podtržítko nebo znaménko rovná se.

Pokud klíče obsahují jiné symboly, doporučujeme je zakódovat pomocí varianty Base64, která je bezpečná pro adresu URL. Například v .NET můžete k tomuto účelu použít metodu HttpServerUtility.UrlTokenEncode .
První znak nemůže být podtržítko. RXhhbXBsZSBkb2N1bWVudCBrZXk=

Řetězec "Příklad klíče dokumentu" zakódovaný v base 64. Doporučuje se kódování Base64 bezpečné pro adresu URL, protože v cestě URL se někdy používají klíče dokumentů. Kódování umožňuje používat v klíči dokumentu znaky, které by jinak byly v adrese URL problematické.
Profil hodnocení 1 - 128 Horní nebo dolní Písmena, číslice, podtržítka (_) První znak musí být písmeno nebo číslo. BoostFunc_TagsCustHist
Navrhovatel 1 - 128 Horní nebo dolní Písmena, číslice, podtržítka (_) První znak musí být písmeno nebo číslo. Sugst01_Apparel
Zdroj dat 1 - 128 Nižší Písmena, číslice, pomlčky (-) První a poslední znak musí být písmeno nebo číslo. docdbds-onlinecatalog-20240228
Indexer 1 -128 Nižší Písmena, číslice, pomlčky (-) První a poslední znak musí být písmeno nebo číslo. docbindxr-onlinecatalog-20240228 řekl:
Mapa synonym 1 -128 Nižší Písmena, číslice, pomlčky (-) První a poslední znak musí být písmeno nebo číslo. vlastní-synonyma-2024
Sada dovedností 1 -128 Nižší Písmena, číslice, pomlčky (-) První a poslední znak musí být písmeno nebo číslo. grok-myfiles-skillset-1 řekl:

Viz také