Szinonimatérkép létrehozása (Azure AI Search REST API)

Az Azure AI Search szinonimatérképe tartalmazza a keresési lekérdezések egyenértékű kifejezésekre való kiterjesztésére vagy újraírására vonatkozó szabályok listáját.

A kérelemhez használhatJA a POST vagy a PUT elemet. Mindkét esetben a kérelem törzsében található JSON-dokumentum biztosítja az objektumdefiníciót.

POST https://[service name].search.windows.net/synonymmaps?api-version=[api-version]      
  Content-Type: application/json  
  api-key: [admin key]  

Másik lehetőségként használhatja a PUT parancsot, és megadhatja a szinonimatérkép nevét az URI-n.

PUT https://[service name].search.windows.net/synonymmaps/[synonymmap name]?api-version=[api-version]  
  Content-Type: application/json  
  api-key: [admin key]  

MINDEN szolgáltatáskéréshez HTTPS szükséges. Ha a szinonimatérkép nem létezik, létrejön. Ha már létezik, az új definícióra frissül.

URI-paraméterek

Kérelemfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérésfejléceket ismerteti.

Kérelem törzse

A kérelem törzse tartalmaz egy szinonimatérkép-definíciót, amely tartalmazza a szinonimatérkép formátumát és a szabályok listáját a megadott formátumban.

A következő JSON a definíció fő részeinek magas szintű ábrázolása.

{   
    "name" : (optional on PUT; required on POST) "Name of the synonym map",  
    "format" : (required) "Only Apache Solr format ('solr') is currently supported.",
    "synonyms" : (required) "Synonym rules separated by the new line ('\n') character.",
    "encryptionKey":(optional) { See below for details } 
}  

A kérelem a következő tulajdonságokat tartalmazza:

Reagálás

Sikeres kérés esetén: 201 Létrehozva.

Példák

Példa: Az egyenértékű és explicit leképezéseket tartalmazó szinonimák listája.

Az egyenértékű leképezési szabály vesszővel elválasztott egyenértékű kifejezéseket vagy kifejezéseket sorol fel ("USA, Egyesült Államok, amerika Egyesült Államok"). A szabály kiterjeszti a keresést az összes egyenértékű kifejezésre vagy kifejezésre. Például egy olyan keresési dokumentum, amely a USA kifejezést USA vagy kifejezéseket tartalmazó lekérdezésekben "United States"egyezik, vagy "United States of America".

Az explicit leképezést egy nyíl => jelöli ("USA, USA, USA, Egyesült Államok, Egyesült Államok Amerika => USA"). Ha meg van adva, a keresési lekérdezés bal oldalának => megfelelő kifejezéssorozatot a jobb oldalon lévő alternatívákra cseréli a rendszer. A szabály alapján a keresési lekérdezések U.S. vagy "United States" az összes újra lesz írva a következőre: USA. Az explicit leképezés csak a megadott irányba vonatkozik, és ebben az esetben nem írja át a lekérdezést USA"United States" . Figyelje meg, hogy a "Egyesült Államok" egy idézőjeles kifejezéses lekérdezés. Ha a teljes kifejezésen egyezést szeretne, a lekérdezési sztringet idézőjelek közé kell tenni. Ellenkező esetben a "United" és az "States" kifejezéseket külön értékelik ki.

{   
  "name" : "synonymmap1",  
  "format" : "solr",  
  "synonyms" : "United States, United States of America, USA\n
  Washington, Wash. => WA"
}  

Példa: Titkosítási kulcsok

A titkosítási kulcsok az ügyfél által felügyelt kulcsok, amelyeket a további titkosításhoz használnak. További információ: Titkosítás ügyfél által felügyelt kulcsokkal az Azure Key Vault.

{   
  "name" : "synonymmap1",  
  "format" : "solr",  
  "synonyms" : "United States, United States of America, USA\n
  Washington, Wash. => WA",
  "encryptionKey": (optional) { 
      "keyVaultKeyName": "Name of the Azure Key Vault key used for encryption",
      "keyVaultKeyVersion": "Version of the Azure Key Vault key",
      "keyVaultUri": "URI of Azure Key Vault, also referred to as DNS name, that provides the key. An example URI might be https://my-keyvault-name.vault.azure.net",
      "accessCredentials": (optional, only if not using managed system identity) {
          "applicationId": "Azure AD Application ID that was granted access permissions to your specified Azure Key Vault",
          "applicationSecret": "Authentication key of the specified Azure AD application)"
      }
  }
}  

Lásd még

• C#-kódminta
• Szinonimák C#-oktatóanyaga a szinonimákról.
• Szinonimák az Azure AI Searchben