Přidání synonym ve službě Azure AI Vyhledávač

Mapa synonym ve vyhledávací službě přidruží ekvivalentní termíny a rozšiřuje rozsah dotazu, aniž by uživatel musel termín skutečně zadat. Například za předpokladu, že pes,psí, a štěňátko jsou mapovaná synonyma, dotaz na psí odpovídá dokumentu obsahujícímu psa. Můžete vytvořit více map synonym pro různé jazyky, jako je angličtina a francouzština nebo lexikony, pokud váš obsah obsahuje technickou žargon, slang nebo nejasnou terminologii.

Klíčové body map synonym jsou:

• Synonymní mapa je zdroj nejvyšší úrovně, který lze vytvořit jednou a být používána mnoha indexy.
• Mapa synonym se vztahuje na řetězcová pole.
• Mapu synonym můžete kdykoli vytvořit a přiřadit bez přerušení indexování nebo dotazů.
• Úroveň služby nastavuje omezení počtu map synonym, které můžete vytvořit.
• Vyhledávací služba může mít více map synonym, ale v indexu může definice pole obsahovat pouze jedno přiřazení mapy synonym.

Vytvoření mapy synonym

Mapa synonym se skládá z názvu, formátu a pravidel, které fungují jako položky mapování synonym. Jediný podporovaný formát je solra solr formát určuje výstavbu pravidla.

Pokud chcete vytvořit mapu synonym, udělejte to programově. Portál Azure nepodporuje definice mapování synonym.

POST /synonymmaps?api-version=2026-04-01
{
    "name": "geo-synonyms",
    "format": "solr",
    "synonyms": "
        USA, United States, United States of America\n
        Washington, Wash., WA => WA\n"
}

Definování pravidel

Pravidla mapování odpovídají specifikaci opensourcového filtru synonym Apache Solru popsaného v tomto dokumentu: SynonymGraphFilter. Formát solr podporuje dva druhy pravidel:

• ekvivalence (kde jsou termíny rovnocennými náhradami v dotazu)

• explicitní mapování (kde se termíny mapují na jeden explicitní termín)

Každé pravidlo je oddělené znakem nového řádku (\n). V bezplatné službě můžete definovat až 5 000 pravidel na mapu synonym a 20 000 pravidel na mapu v jiných úrovních. Každé pravidlo může mít až 20 rozšíření nebo položek v pravidle. Další informace najdete v tématu Omezení synonym.

Analyzátory dotazů automaticky převádějí velká nebo smíšená písmena na malá. Chcete-li zachovat speciální znaky v řetězci, například čárku nebo pomlčku, přidejte při vytváření mapy synonym příslušné řídicí znaky.

Pravidla ekvivalence

Pravidla pro ekvivalentní termíny jsou v rámci stejného pravidla oddělená čárkami. V prvním příkladu se dotaz na USA rozšíří na USA OR "USA" OR "USA of America." Pokud chcete hledat shodu s frází, musí být samotný dotaz frázovým dotazem uzavřeným v uvozovkách.

V případě ekvivalence je dotaz na pes rozšířen o štěně a kaninec.

{
"format": "solr",
"synonyms": "
    USA, United States, United States of America\n
    dog, puppy, canine\n
    coffee, latte, cup of joe, java\n"
}

Explicitní mapování

Pravidla explicitního mapování jsou označena šipkou =>. Když je zadána sekvence klíčových slov vyhledávacího dotazu, která odpovídá levé straně =>, nahradí se alternativami na pravé straně při zpracování dotazu.

V konkrétním případě se dotaz pro Washington, Wash. nebo WA přepíše jako WA a dotazovací modul hledá pouze shody ve výrazu WA. Explicitní mapování se použije pouze ve zadaném směru a v tomto případě dotaz WA nepřepíše na Washington.

{
"format": "solr",
"synonyms": "
    Washington, Wash., WA => WA\n
    California, Calif., CA => CA\n"
}

Escapování speciálních znaků

Synonyma se analyzují během zpracování dotazů stejně jako jakýkoli jiný termín dotazu, což znamená, že pravidla vyhrazených a speciálních znaků se vztahují na termíny v mapě synonym. Seznam znaků, které vyžadují escapování, se liší mezi jednoduchou syntaxí a úplnou syntaxí.

• jednoduchá syntaxe+ | " ( ) ' \
• úplná syntaxe+ - & | ! ( ) { } [ ] ^ " ~ * ? : \ /

Chcete-li zachovat znaky, které výchozí analyzátor zahodí, nahraďte analyzátorem, který je zachová. Možnosti zahrnují analyzátory přirozeného jazyka Microsoft, které zachovávají slova s pomlčkou, nebo vlastní analyzátor pro komplexnější struktury. Další informace naleznete v části Částečné termíny, vzory a speciální znaky.

Následující příklad ukazuje, jak upravit znak pomocí zpětného lomítka:

{
    "format": "solr",
    "synonyms": "WA\, USA, WA, Washington\n"
}

Vzhledem k tomu, že zpětné lomítko je v jiných jazycích, jako je JSON a C#, speciální znak, pravděpodobně ho budete muset dvojitě uvozit. Tady je příklad ve formátu JSON:

{
    "format":"solr",
    "synonyms": "WA\\, USA, WA, Washington"
}

Správa map synonym

Mapu synonym můžete aktualizovat bez přerušení úloh dotazování a indexování. Jakmile přidáte mapu synonym do pole a poté tuto mapu odstraníte, každý dotaz obsahující tato pole skončí s chybou 404.

Vytvoření, aktualizace a odstranění mapy synonym je vždy operace celého dokumentu. Části mapy synonym nemůžete přírůstkově aktualizovat ani odstranit. Aktualizace i jednoho pravidla vyžaduje opětovné načtení.

Přiřaďte synonyma k polím

Po vytvoření mapy synonym ji přiřaďte k poli v indexu. Přiřazení map synonym proveďte programově. Portál Azure nepodporuje přidružení polí mapování synonym.

• Pole musí být typu Edm.String nebo Collection(Edm.String)
• Pole musí obsahovat "searchable":true
• Pole může mít pouze jednu mapu synonym.

Pokud mapa synonym ve vyhledávací službě existuje, použije se v dalším dotazu bez nutnosti přeindexování nebo opětovného sestavení.

PUT /indexes?api-version=2026-04-01
{
    "name":"hotels-sample",
    "fields":[
        {
            "name":"description",
            "type":"Edm.String",
            "searchable":true,
            "synonymMaps":[
            "en-synonyms"
            ]
        },
        {
            "name":"description_fr",
            "type":"Edm.String",
            "searchable":true,
            "analyzer":"fr.microsoft",
            "synonymMaps":[
            "fr-synonyms"
            ]
        }
    ]
}

// Update an index
string indexName = "hotels";
SearchIndex index = new SearchIndex(indexName)
{
    Fields =
    {
        new SimpleField("hotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true },
        new SearchableField("hotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("description") { AnalyzerName = LexicalAnalyzerName.EnLucene },
        new SearchableField("descriptionFr") { AnalyzerName = LexicalAnalyzerName.FrLucene }
        new ComplexField("address")
        {
            Fields =
            {
                new SearchableField("streetAddress"),
                new SearchableField("city") { IsFilterable = true, IsSortable = true, IsFacetable = true },
                new SearchableField("stateProvince") { IsFilterable = true, IsSortable = true, IsFacetable = true },
                new SearchableField("country") { SynonymMapNames = new[] { synonymMapName }, IsFilterable = true, IsSortable = true, IsFacetable = true },
                new SearchableField("postalCode") { IsFilterable = true, IsSortable = true, IsFacetable = true }
            }
        }
    }
};

await indexClient.CreateIndexAsync(index);

Dotaz na ekvivalentní nebo mapovaná pole

Přiřazení pole synonyma nemění způsob psaní dotazů. Jediným rozdílem po přiřazení mapy synonym je, že pokud v mapě synonym existuje termín dotazu, vyhledávací web buď rozbalí nebo přepíše termín nebo frázi v závislosti na pravidlu.

Jak se používají synonyma při provádění dotazu

Synonyma jsou technika rozšíření dotazu, která doplňuje obsah indexu ekvivalentními termíny, ale pouze pro pole, která mají přiřazení synonyma. Pokud dotaz s oborem pole vyloučí pole s povoleným synonymem, nezobrazí se shody z mapy synonym.

U polí s povoleným synonymem se synonyma řídí stejnou textovou analýzou jako přidružené pole. Pokud je například pole analyzováno pomocí standardního analyzátoru Lucene, termíny synonym se vztahují také na standardní analyzátor Lucene v době dotazu. Pokud chcete zachovat interpunkci, jako jsou tečky nebo pomlčky, použijte v poli analyzátor, který zachovává obsah.

Funkce synonym interně přepisuje původní dotaz synonymy za použití operátoru OR. Z tohoto důvodu se pomocí zvýrazňování a bodování profilů zachází s původním termínem a synonymy jako s ekvivalentem.

Synonyma se vztahují pouze na dotazy s textem ve volném formátu a nejsou podporována pro filtry, atributy, automatické dokončování nebo návrhy. Automatické dokončování a návrhy jsou založeny pouze na původním termínu; v odpovědi se nezobrazují shody synonym.

Pokud máte existující index ve vývojovém (neprodukčním) prostředí, experimentujte s malým slovníkem a podívejte se, jak přidání synonym mění možnosti hledání, včetně dopadu na bodovací profily, zvýraznění hitů a návrhů.

Hledání pomocí zástupných znaků

Expanze synonym se nevztahují na zástupné hledací výrazy; prefixové, fuzzy a regexové výrazy nejsou rozšířeny.

Pokud potřebujete provést jeden dotaz, který použije rozšíření synonym a zástupné znaky, regulární výrazy nebo přibližné vyhledávání, můžete dotazy kombinovat pomocí syntaxe OR. Pokud chcete například zkombinovat synonyma se zástupnými znaky pro jednoduchou syntaxi dotazu, termín by byl <query> | <query>*.

Další krok