Beispiele für die vollständige Lucene-Suchsyntax (erweiterte Abfragen)

Artikel
10/31/2024

Beim Erstellen von Abfragen für Azure KI Search können Sie den standardmäßigen einfachen Abfrageparser durch den leistungsfähigeren Lucene-Abfrageparser ersetzen, um spezialisierte und erweiterte Abfrageausdrücke zu formulieren.

Der Lucene-Parser unterstützt komplexe Abfrageformate, z. B. feldbezogene Abfragen, Fuzzysuche, Infix- und Suffixplatzhaltersuche, NEAR-Suche, Term Boosting (Begriffsverstärkung) und die Suche mit regulären Ausdrücken. Die zusätzliche Leistung kommt mit zunehmenden Verarbeitungsanforderungen, stellen Sie sich deshalb auf eine etwas längere Ausführungsdauer ein. In diesem Artikel finden Sie Beispiele, in denen Abfragevorgänge basierend auf der vollständigen Syntax veranschaulicht werden.

Hinweis

Viele der spezialisierten Abfragekonstruktionen, die über die vollständige Lucene-Abfragesyntax aktiviert werden, verfügen nicht über eine Textanalyse. Dies kann zu Überraschungen führen, wenn Sie mit Wortstammerkennung und Lemmatisierung rechnen. Die lexikalische Analyse erfolgt nur für vollständige Begriffe (Begriffsabfrage oder Ausdrucksabfrage). Abfragetypen mit unvollständigen Begriffen (Präfixabfrage, Platzerhalterabfrage, Abfrage regulärer Ausdrücke, Fuzzyabfrage) werden direkt unter Umgehung der Analysephase an die Abfragestruktur angehängt. Die einzige Transformation, die für partielle Abfrageausdrücke durchgeführt wird, ist die Umwandlung in Kleinbuchstaben.

Beispielindex für Hotels

Die folgenden Abfragen basieren auf „hotels-sample-index“. Diesen Index können Sie mithilfe der Anweisungen in diesem Schnellstart erstellen.

Beispielabfragen werden mithilfe der REST-API und POST-Anforderungen formuliert. Sie können sie in einen REST-Clienteinfügen und ausführen. Oder verwenden Sie die JSON-Ansicht des Such-Explorers im Azure-Portal. In der JSON-Ansicht können Sie die hier gezeigten Abfragebeispiele in diesem Artikel einfügen.

Anforderungsheader müssen die folgenden Werte aufweisen:

Schlüssel	Wert
Inhaltsart	Anwendung/json
api-key	`<your-search-service-api-key>`, entweder Abfrage- oder Administratorschlüssel

URI-Parameter müssen Ihren Suchdienstendpunkt mit dem Indexnamen, den Dokumentationssammlungen, dem Suchbefehl und der API-Version enthalten, ähnlich wie im folgenden Beispiel gezeigt:

https://{{service-name}}.search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2024-07-01

Der Anforderungstext muss als gültiger JSON-Code vorliegen:

{
    "search": "*",
    "queryType": "full",
    "select": "HotelId, HotelName, Category, Tags, Description",
    "count": true
}

Wenn search auf „*“ festgelegt ist, erfolgt die Abfrage ohne Angaben und entspricht einer NULL-Suche oder leeren Suche. Es ist nicht besonders nützlich, aber es ist die einfachste Suche, die Sie durchführen können, und sie zeigt alle abrufbaren Felder im Index mit allen Werten.
Wenn queryType auf full festgelegt ist, wird der vollständige Lucene-Abfrageparser aufgerufen. Dieser ist für diese Syntax erforderlich.
select ist auf eine durch Trennzeichen getrennte Liste von Feldern festgelegt und wird zur Zusammenstellung von Suchergebnissen verwendet. Es werden nur die Felder einbezogen, die im Kontext von Suchergebnissen nützlich sind.
count gibt die Anzahl der Dokumente zurück, die mit den Suchkriterien übereinstimmen. Bei einem leeren Suchbegriff werden alle Dokumente im Index gezählt (50 im „hotels-sample-index“).

Beispiel 1: Feldbezogene Suche

Die feldbezogene Suche bezieht sich auf einzelne, eingebettete Suchausdrücke für ein bestimmtes Feld. In diesem Beispiel wird nach Namen von Hotels gesucht, die den Begriff Hotel, aber nicht den Begriff Motel enthalten. Sie können mehrere Felder mithilfe von AND angeben.

Bei Verwendung dieser Abfragesyntax können Sie den Parameter searchFields auslassen, wenn sich die Felder, die Sie abfragen möchten, im Suchausdruck selbst befinden. Wenn Sie searchFields in die feldbasierte Suche einbeziehen, hat fieldName:searchExpression immer Vorrang vor searchFields .

POST /indexes/hotel-samples-index/docs/search?api-version=2024-07-01
{
    "search": "HotelName:(hotel NOT motel) AND Category:'Boutique'",
    "queryType": "full",
    "select": "HotelName, Category",
    "count": true
}

Die Antwort für diese Abfrage sollte ähnlich wie im folgenden Beispiel aussehen, gefiltert nach Boutique, und gibt Hotels zurück, die Hotel im Namen aufweisen. Dabei werden Ergebnisse ausgeschlossen, die Motel im Namen enthalten.

{
  "@odata.count": 5,
  "value": [
    {
      "@search.score": 2.2289815,
      "HotelName": "Stay-Kay City Hotel",
      "Category": "Boutique"
    },
    {
      "@search.score": 1.3862944,
      "HotelName": "City Skyline Antiquity Hotel",
      "Category": "Boutique"
    },
    {
      "@search.score": 1.355046,
      "HotelName": "Old Century Hotel",
      "Category": "Boutique"
    },
    {
      "@search.score": 1.355046,
      "HotelName": "Sublime Palace Hotel",
      "Category": "Boutique"
    },
    {
      "@search.score": 1.355046,
      "HotelName": "Red Tide Hotel",
      "Category": "Boutique"
    }
  ]
}

Bei dem Suchausdruck kann es sich um einen einzelnen Begriff, einen einfachen Ausdruck oder einen komplexeren Ausdruck in Klammern handeln, optional mit booleschen Operatoren. Einige Beispiele für Änderungen sind in der folgenden Liste aufgeführt:

HotelName:(hotel NOT motel)
Address/StateProvince:("WA" OR "CA")
Tags:("free wifi" NOT "free parking") AND "coffee in lobby"

Achten Sie darauf, dass Sie einen Ausdruck in Anführungszeichen setzen, wenn beide Zeichenfolgen als einzelne Entität ausgewertet werden sollen, da in diesem Fall im Feld Address/StateProvince nach zwei verschiedenen Standorten gesucht wird. Abhängig vom Client müssen Sie die Anführungszeichen möglicherweise mit Escapezeichen (\) versehen.

Das in fieldName:searchExpression angegebene Feld muss ein durchsuchbares Feld sein. Informationen dazu, wie Felddefinitionen zugeschrieben werden, finden Sie unter Create Index (REST API).

Beispiel 2: Fuzzysuche

Bei der Fuzzysuche stimmen ähnliche Begriffe überein, einschließlich falsch geschriebener Wörter. Hängen Sie für eine Fuzzysuche das Tildesymbol ~ an das Ende eines einzelnen Worts mit einem optionalen Parameter an, einem Wert zwischen 0 und 2, der die Editierdistanz angibt. Beispielsweise würden bei blue~ oder blue~1 die Werte „blue“, „blues“ und „glue“ zurückgegeben.

POST /indexes/hotel-samples-index/docs/search?api-version=2024-07-01
{
    "search": "Tags:conserge~",
    "queryType": "full",
    "select": "HotelName, Category, Tags",
    "searchFields": "HotelName, Category, Tags",
    "count": true
}

Die Antwort für diese Abfrage (der Übersicht halber gekürzt) wird in den übereinstimmenden Dokumenten in Portier aufgelöst:

{
  "@odata.count": 9,
  "value": [
    {
      "@search.score": 1.4947624,
      "HotelName": "Twin Vortex Hotel",
      "Category": "Luxury",
      "Tags": [
        "bar",
        "restaurant",
        "concierge"
      ]
    },
    {
      "@search.score": 1.1685618,
      "HotelName": "Stay-Kay City Hotel",
      "Category": "Boutique",
      "Tags": [
        "view",
        "air conditioning",
        "concierge"
      ]
    },
    {
      "@search.score": 1.1465473,
      "HotelName": "Old Century Hotel",
      "Category": "Boutique",
      "Tags": [
        "pool",
        "free wifi",
        "concierge"
      ]
    },
. . .
  ]
}

Ausdrücke werden nicht direkt unterstützt. Sie können jedoch eine Fuzzyübereinstimmung für jeden Begriff eines mehrteiligen Ausdrucks angeben, wie z. B. search=Tags:landy~ AND sevic~. Dieser Abfrageausdruck findet 15 Übereinstimmungen für Wäscheservice.

Hinweis

Fuzzyabfragen werden nicht analysiert. Abfragetypen mit unvollständigen Begriffen (Präfixabfrage, Platzerhalterabfrage, Abfrage regulärer Ausdrücke, Fuzzyabfrage) werden direkt unter Umgehung der Analysephase an die Abfragestruktur angehängt. Die einzige Transformation, die für Teilabfrageausdrücke durchgeführt wird, ist die Umwandlung in Kleinbuchstaben.

Beispiel 3: NEAR-Suche

Bei der NEAR-Suche wird nach Begriffen gesucht, die in einem Dokument nahe beieinander vorkommen. Fügen Sie ein Tildezeichen ~ am Ende eines Ausdrucks ein, gefolgt von der Anzahl der Wörter, die den NEAR-Bereich bilden.

Diese Abfrage sucht nach den Begriffen Hotel und Flughafen, wenn diese in einem Abstand von fünf Wörtern in einem Dokument vorkommen. Die Anführungszeichen werden mit Escapezeichen versehen (\"), um den Ausdruck beizubehalten:

POST /indexes/hotel-samples-index/docs/search?api-version=2024-07-01
{
    "search": "Description: \"hotel airport\"~5",
    "queryType": "full",
    "select": "HotelName, Description",
    "searchFields": "HotelName, Description",
    "count": true
}

Die Antwort auf diese Abfrage sollte in etwa wie im folgenden Beispiel aussehen:

{
  "@odata.count": 1,
  "value": [
    {
      "@search.score": 0.69167054,
      "HotelName": "Trails End Motel",
      "Description": "Only 8 miles from Downtown. On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, All non-smoking hotel. Only 15 miles from airport."
    }
  ]
}

Beispiel 4: Term Boosting

Term Boosting bezieht sich auf das Höherbewerten eines Dokuments, das den verstärkten Begriff enthält, im Vergleich zu Dokumenten, die den Begriff nicht enthalten. Verwenden Sie zum Verstärken eines Begriffs das Caretzeichen (^) mit einem Verstärkungsfaktor (einer Zahl) am Ende des Begriffs, nach dem Sie suchen. Der Standardwert für den Verstärkungsfaktor ist 1. Der Faktor muss zwar positiv sein, darf jedoch kleiner als 1 sein (z. B. 0,2). Das Term Boosting unterscheidet sich von Bewertungsprofilen darin, dass bei Bewertungsprofilen anstelle von bestimmten Begriffen bestimmte Felder verstärkt werden.

Suchen Sie in dieser vorher-Abfrage nach Strandzugang. Es gibt sieben Dokumente, die einen oder beide Begriffe enthalten.

POST /indexes/hotel-samples-index/docs/search?api-version=2024-07-01
{
    "search": "beach access",
    "queryType": "full",
    "select": "HotelName, Description, Tags",
    "searchFields": "HotelName, Description, Tags",
    "count": true
}

Tatsächlich stimmen nur zwei Dokumente bei Zugang überein. Das erste Dokument befindet sich an zweiter Position, obwohl der Begriff Strand fehlt.

{
  "@odata.count": 6,
  "value": [
    {
      "@search.score": 1.068669,
      "HotelName": "Johnson's Family Resort",
      "Description": "Family oriented resort located in the heart of the northland. Operated since 1962 by the Smith family, we have grown into one of the largest family resorts in the state. The home of excellent Smallmouth Bass fishing with 10 small cabins, we're a home not only to fishermen but their families as well. Rebuilt in the early 2000's, all of our cabins have all the comforts of home. Sporting a huge **beach** with multiple water toys for those sunny summer days and a Lodge full of games for when you just can't swim anymore, there's always something for the family to do. A full marina offers watercraft rentals, boat launch, powered dock slips, canoes (free to use), & fish cleaning facility. Rent pontoons, 14' fishing boats, 16' fishing rigs or jet ski's for a fun day or week on the water. Pets are accepted in the lakeside cottages.",
      "Tags": [
        "24-hour front desk service",
        "pool",
        "coffee in lobby"
      ]
    },
    {
      "@search.score": 1.0162708,
      "HotelName": "Campus Commander Hotel",
      "Description": "Easy **access** to campus and steps away from the best shopping corridor in the city. From meetings in town or gameday, enjoy our prime location between the union and proximity to the university stadium.",
      "Tags": [
        "free parking",
        "coffee in lobby",
        "24-hour front desk service"
      ]
    },
    {
      "@search.score": 0.9050383,
      "HotelName": "Lakeside B & B",
      "Description": "Nature is Home on the **beach**. Explore the shore by day, and then come home to our shared living space to relax around a stone fireplace, sip something warm, and explore the library by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.",
      "Tags": [
        "laundry service",
        "concierge",
        "free parking"
      ]
    },
    {
      "@search.score": 0.8955848,
      "HotelName": "Windy Ocean Motel",
      "Description": "Oceanfront hotel overlooking the **beach** features rooms with a private balcony and 2 indoor and outdoor pools. Inspired by the natural beauty of the island, each room includes an original painting of local scenes by the owner. Rooms include a mini fridge, Keurig coffee maker, and flatscreen TV. Various shops and art entertainment are on the boardwalk, just steps away.",
      "Tags": [
        "pool",
        "air conditioning",
        "bar"
      ]
    },
    {
      "@search.score": 0.83636594,
      "HotelName": "Happy Lake Resort & Restaurant",
      "Description": "The largest year-round resort in the area offering more of everything for your vacation – at the best value! What can you enjoy while at the resort, aside from the mile-long sandy **beaches** of the lake? Check out our activities sure to excite both young and young-at-heart guests. We have it all, including being named “Property of the Year” and a “Top Ten Resort” by top publications.",
      "Tags": [
        "pool",
        "bar",
        "restaurant"
      ]
    },
    {
      "@search.score": 0.7808502,
      "HotelName": "Swirling Currents Hotel",
      "Description": "Spacious rooms, glamorous suites and residences, rooftop pool, walking **access** to shopping, dining, entertainment and the city center. Each room comes equipped with a microwave, a coffee maker and a minifridge. In-room entertainment includes complimentary W-Fi and flat-screen TVs. ",
      "Tags": [
        "air conditioning",
        "laundry service",
        "24-hour front desk service"
      ]
    }
  ]
}

Wiederholen Sie die Suche mit der Nachher-Abfrage, und verstärken Sie dieses Mal die Ergebnisse mit dem Begriff Strand gegenüber dem Begriff Zugang. Eine für Menschen lesbare Version der Abfrage ist search=Description:beach^2 access. Abhängig vom Client müssen Sie ^2 möglicherweise als %5E2 formulieren.

POST /indexes/hotel-samples-index/docs/search?api-version=2024-07-01
{
    "search": "Description:beach^2 access",
    "queryType": "full",
    "select": "HotelName, Description, Tags",
    "searchFields": "HotelName, Description, Tags",
    "count": true
}

Nachdem Sie die Priorität des Begriffs Strand erhöht haben, rutscht das Campus Commander Hotel auf den fünften Platz.

{
  "@odata.count": 6,
  "value": [
    {
      "@search.score": 2.137338,
      "HotelName": "Johnson's Family Resort",
      "Description": "Family oriented resort located in the heart of the northland. Operated since 1962 by the Smith family, we have grown into one of the largest family resorts in the state. The home of excellent Smallmouth Bass fishing with 10 small cabins, we're a home not only to fishermen but their families as well. Rebuilt in the early 2000's, all of our cabins have all the comforts of home. Sporting a huge beach with multiple water toys for those sunny summer days and a Lodge full of games for when you just can't swim anymore, there's always something for the family to do. A full marina offers watercraft rentals, boat launch, powered dock slips, canoes (free to use), & fish cleaning facility. Rent pontoons, 14' fishing boats, 16' fishing rigs or jet ski's for a fun day or week on the water. Pets are accepted in the lakeside cottages.",
      "Tags": [
        "24-hour front desk service",
        "pool",
        "coffee in lobby"
      ]
    },
    {
      "@search.score": 1.8100766,
      "HotelName": "Lakeside B & B",
      "Description": "Nature is Home on the beach. Explore the shore by day, and then come home to our shared living space to relax around a stone fireplace, sip something warm, and explore the library by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.",
      "Tags": [
        "laundry service",
        "concierge",
        "free parking"
      ]
    },
    {
      "@search.score": 1.7911696,
      "HotelName": "Windy Ocean Motel",
      "Description": "Oceanfront hotel overlooking the beach features rooms with a private balcony and 2 indoor and outdoor pools. Inspired by the natural beauty of the island, each room includes an original painting of local scenes by the owner. Rooms include a mini fridge, Keurig coffee maker, and flatscreen TV. Various shops and art entertainment are on the boardwalk, just steps away.",
      "Tags": [
        "pool",
        "air conditioning",
        "bar"
      ]
    },
    {
      "@search.score": 1.6727319,
      "HotelName": "Happy Lake Resort & Restaurant",
      "Description": "The largest year-round resort in the area offering more of everything for your vacation – at the best value! What can you enjoy while at the resort, aside from the mile-long sandy beaches of the lake? Check out our activities sure to excite both young and young-at-heart guests. We have it all, including being named “Property of the Year” and a “Top Ten Resort” by top publications.",
      "Tags": [
        "pool",
        "bar",
        "restaurant"
      ]
    },
    {
      "@search.score": 1.0162708,
      "HotelName": "Campus Commander Hotel",
      "Description": "Easy access to campus and steps away from the best shopping corridor in the city. From meetings in town or gameday, enjoy our prime location between the union and proximity to the university stadium.",
      "Tags": [
        "free parking",
        "coffee in lobby",
        "24-hour front desk service"
      ]
    },
    {
      "@search.score": 0.7808502,
      "HotelName": "Swirling Currents Hotel",
      "Description": "Spacious rooms, glamorous suites and residences, rooftop pool, walking access to shopping, dining, entertainment and the city center. Each room comes equipped with a microwave, a coffee maker and a minifridge. In-room entertainment includes complimentary W-Fi and flat-screen TVs. ",
      "Tags": [
        "air conditioning",
        "laundry service",
        "24-hour front desk service"
      ]
    }
  ]
}

Beispiel 5: Regulärer Ausdruck

Bei einer Suche mit regulärem Ausdruck werden Übereinstimmungen basierend auf dem Inhalt zwischen Schrägstrichen / gefunden, wie in der RegExp-Klasse dokumentiert.

POST /indexes/hotel-samples-index/docs/search?api-version=2024-07-01
{
    "search": "HotelName:/(Mo|Ho)tel/",
    "queryType": "full",
    "select": "HotelName",
    "count": true
}

Das Ergebnis dieser Abfrage sollte in etwa wie im folgenden gekürzten Beispiel aussehen:

{
  "@odata.count": 25,
  "value": [
    {
      "@search.score": 1,
      "HotelName": "Country Residence Hotel"
    },
    {
      "@search.score": 1,
      "HotelName": "Downtown Mix Hotel"
    },
    {
      "@search.score": 1,
      "HotelName": "Gastronomic Landscape Hotel"
    },
    . . . 
    {
      "@search.score": 1,
      "HotelName": "Trails End Motel"
    },
    {
      "@search.score": 1,
      "HotelName": "Nordick's Valley Motel"
    },
    {
      "@search.score": 1,
      "HotelName": "King's Cellar Hotel"
    }
  ]
}

Hinweis

Abfragen mit regulärem Ausdruck werden nicht analysiert. Die einzige Transformation, die für Teilabfrageausdrücke durchgeführt wird, ist die Umwandlung in Kleinbuchstaben.

Beispiel 6: Platzhaltersuche

Sie können die allgemein bekannte Syntax für die Platzhaltersuche nach mehreren (*) oder einzelnen (?) Zeichen verwenden. Der Lucene-Abfrageparser unterstützt die Verwendung dieser Symbole bei einem einzelnen Begriff, nicht bei einem Ausdruck.

In dieser Abfrage suchen Sie nach den Namen von Hotels, die das Präfix sc enthalten. Das Symbol * oder ? kann nicht als erstes Zeichen in einer Suche verwendet werden.

POST /indexes/hotel-samples-index/docs/search?api-version=2024-07-01
{
    "search": "HotelName:sc*",
    "queryType": "full",
    "select": "HotelName",
    "count": true
}

Die Antwort auf diese Abfrage sollte in etwa wie im folgenden Beispiel aussehen:

{
  "@odata.count": 1,
  "value": [
    {
      "@search.score": 1,
      "HotelName": "Waterfront Scottish Inn"
    }
  ]
}

Hinweis

Abfragen mit Platzhaltern werden nicht analysiert. Die einzige Transformation, die für Teilabfrageausdrücke durchgeführt wird, ist die Umwandlung in Kleinbuchstaben.

Versuchen Sie, Abfragen im Code anzugeben. Unter dem folgenden Link wird erläutert, wie Suchabfragen mithilfe der Azure SDKs eingerichtet werden.

Schnellstart: Volltextsuche mithilfe der Azure SDKs

Eine zusätzliche Syntaxreferenz, eine Abfragearchitektur und Beispiele finden Sie unter den folgenden Artikeln:

Freigeben über

Beispiele für die vollständige Lucene-Suchsyntax (erweiterte Abfragen)

Beispielindex für Hotels

Beispiel 1: Feldbezogene Suche

Beispiel 2: Fuzzysuche

Beispiel 3: NEAR-Suche

Beispiel 4: Term Boosting

Beispiel 5: Regulärer Ausdruck

Beispiel 6: Platzhaltersuche

Feedback

Zusätzliche Ressourcen

Freigeben über

Beispiele für die vollständige Lucene-Suchsyntax (erweiterte Abfragen)

Beispielindex für Hotels

Beispiel 1: Feldbezogene Suche

Beispiel 2: Fuzzysuche

Beispiel 3: NEAR-Suche

Beispiel 4: Term Boosting

Beispiel 5: Regulärer Ausdruck

Beispiel 6: Platzhaltersuche

Zugehöriger Inhalt

Feedback

Zusätzliche Ressourcen