Struktur für eine optimale Abfrageinterpretation strukturieren

Die Abfrageauswertung von Cloud Search interpretiert automatisch die Operatoren und Filter in der Suchanfrage eines Nutzers und wandelt diese Elemente in eine strukturierte, operatorbasierte Abfrage um. Bei der Abfrageauswertung werden die im Schema definierten Operatoren zusammen mit den indexierten Dokumenten verwendet, um die Bedeutung der Suchanfrage des Nutzers zu ermitteln. Mit dieser Funktion können Nutzer mit wenigen Suchbegriffen suchen und erhalten dennoch präzise Ergebnisse.

Die tatsächlichen Ergebnisse, die dem Nutzer angezeigt werden, hängen vom Vertrauensniveau der Abfrageinterpretation ab. Die Zuverlässigkeit basiert auf mehreren Faktoren, unter anderem darauf, wo die Suchstrings in indexierten Dokumenten vorkommen. Ein String wie der Name des Schauspielers "Tom Hanks", der konsistent in einem Schemafeld namens actors erscheint, führt zu einer höheren Konfidenz. Wenn derselbe String („Tom Hanks“) in einem Absatz und nicht in einem Schemafeld erscheint, kann das zu einer geringeren Konfidenz führen. Bei hoher Wahrscheinlichkeit werden dem Nutzer nur Ergebnisse aus der Abfrageinterpretation angezeigt. Bei geringerer Sicherheit werden die Ergebnisse der Abfrageinterpretation mit den Ergebnissen einer normalen Keyword-Suche kombiniert.

Hinweis :Bevor Sie dieses Dokument lesen, sollten Sie sich mit der grundlegenden Struktur von Schemas vertraut machen. Lesen Sie dazu Schema erstellen und registrieren. Lesen Sie auch den Hilfeartikel Suchqualität verbessern, um das Ranking und die Trefferquote zu verbessern.

Beispiel für die Interpretation einer Abfrage

Angenommen, Sie haben eine Datenquelle, z. B. eine Datenbank, die Informationen zu Filmen enthält. Abbildung 1 zeigt eine Beispielsuchanfrage und die daraus resultierende Interpretation.

Abbildung 1. Abfrageauswertung

In dieser Beispielabfrage erfolgt die Abfrageinterpretation so:

• Parst das Schema und stellt fest, dass die Objekte der obersten Ebene in der Datenquelle als objecttype:movies klassifiziert sind. Die Abfrageauswertung weiß jetzt, dass „movies“ in der Abfrage ein Objekttyp ist.

• Es werden Dokumente in der Datenquelle in Verbindung mit dem Schema gescannt, um zu ermitteln, wo der String „Aktion“ vorkommt. Wenn der String hauptsächlich in einem bestimmten Datenquellenfeld „Genre“ vorkommt, ist bei der Abfrageauswertung die Wahrscheinlichkeit hoch, dass „Action“ ein Attributwert für das im Schema definierte Attribut „Genre“ ist. Wenn der String hauptsächlich im Kontext von Textabsätzen vorkommt, sinkt das Konfidenzniveau der Abfrageinterpretation.

Die Abfrage wird so interpretiert:

  actor:“tom hanks” genre:action objecttype:movies

Die Suchanfrage-Interpretation wird für alle Cloud Search-Kunden automatisch aktiviert. Für eine optimale Abfrageauswertung sollten Sie Ihr Schema jedoch gemäß der Anleitung in diesem Dokument strukturieren.

Strukturieren Sie Ihr Schema, um die Interpretation von Abfragen zu unterstützen

Sie sollten Ihr Schema so strukturieren, dass Sie von der Abfrageauswertung profitieren können.

Hinweis: Nachdem ein Schema und die entsprechenden Dokumente indexiert wurden, dauert es mindestens 48 Stunden, bis Suchanfragen interpretiert werden können.

Interpretationen von Anzeigenamen aktivieren

Bei der Abfrageauswertung von Cloud Search werden die Elemente objectDefinitions und propertyDefinitions in einem Schema verwendet, um die Suchanfrage eines Nutzers zu interpretieren und die Ergebnisse zu optimieren. Um diese Schemaelemente optimal zu nutzen, sollten Sie intuitive Anzeigenamen erstellen. Verwenden Sie dazu displayLabel für Eigenschaftsnamen, objectDisplayLabel für Objektnamen und operatorName für Operatoren.

Das folgende Schema zeigt intuitive Anzeigenamen für ein Filmobjekt:

{
  "objectDefinitions": [
    {
      "name": "movie",
        "options": {
          "displayOptions": {
          "objectDisplayLabel": "Films"
        }
        ...
      },
      "propertyDefinitions": [
        {
          "name": "genre",
          "isReturnable": true,
          "isRepeatable": true,
          "isFacetable": true,
          "textPropertyOptions": {
          "retrievalImportance": { "importance": "HIGHEST" },
          "operatorOptions": {
            "operatorName": "genre"
          }
        },
        "displayOptions": {
          "displayLabel": "Category"
        }
      },
      ...
      ]
    }
  ]
}

Im vorherigen Beispiel:

• Die Filmobjektdefinition enthält ein „Film“-objectDisplayLabel.

  Hinweis: Im Gegensatz zum Filmschema im Artikel Schema erstellen und registrieren hat das vorherige Beispiel einen anderen Wert für objectDisplayLabel und name des Objekts. Für diese Felder ist ein anderer Wert zulässig.

• Die Genre-PropertyDefinition hat ein „Genre“ operatorName und eine „Kategorie“ displayLabel.

Mit diesen Anzeigenamen kann Cloud Search die folgenden Abfragen interpretieren:

• „Actionfilme“, „Filme mit Genre-Actionfilmen“ und „Filme & Genre-Action“ werden als genre:action object:movies interpretiert.
• „Filme mit dem Genre Action oder Thriller“ wird als objecttype:movies genre:(action OR thriller) interpretiert.
• „Actionfilm“ oder „Actionfilme“ wird als genre:action objecttype:movies interpretiert.
• „Komödien – Filme“ wird als genre:comedy objecttype:movies interpretiert.

Hinweis: Verwenden Sie für Property-Namen die Camel Case-Schreibweise, um die Funktion zur Abfrageinterpretation von Cloud Search zu unterstützen.

Datums-, Zahlen- und Sortierinterpretationen aktivieren

Sie sollten lessThanOperatorName und greaterThanOperatorName, wie in IntegerOperatorOptions angegeben, für alle Datums- und numerischen Properties definieren. Mit diesen Einstellungen werden automatische Datums- und Zahleninterpretationen aktiviert. Wenn Sie Sortierinterpretationen aktivieren möchten, legen Sie für Datums- und numerische Properties die Option isSortable fest. Das folgende Schema zeigt, wie diese Optionen aktiviert werden.

{
  "objectDefinitions": [
    {
      "options": {
        "displayOptions": {
          "objectDisplayLabel": "Films"
        }
      },
      "propertyDefinitions": [
        {
          "name": "runtime",
          "isReturnable": true,
          "isSortable": true,
          "integerPropertyOptions": {
            "orderedRanking": "DESCENDING",
            "minimumValue": {
              "value": 10
            },
            "maximumValue": {
              "value": 500
            },
            "operatorOptions": {
              "operatorName": "runtime",
              "lessThanOperatorName": "runtimelessthan",
              "greaterThanOperatorName": "runtimegreaterthan"
            }
          },
          "displayOptions": {
            "displayLabel": "Length"
          }
        },
        {
          "name": "releasedate",
          "isReturnable": true,
          "isSortable": true,
          "datePropertyOptions": {
            "operatorOptions": {
              "operatorName": "releasedate",
              "lessThanOperatorName": "releasedbefore",
              "greaterThanOperatorName": "releasedafter"
            }
          }
        }
      ]
    }
  ]
}

Im vorherigen Beispiel:

• Die numerische Eigenschaft runtime bezieht sich auf die Länge eines Films. Für diese Property sind runtimelessthan und runtimegreaterthan festgelegt.
• Die Datumseigenschaft releaseDate gibt an, wann ein Film ins Kino kommt. Für diese Property sind releasedbefore und releasedafter festgelegt.

Mit diesen Einstellungen kann Cloud Search die folgenden Suchanfragen interpretieren:

• Angenommen, das Jahr ist 2019, wird „in diesem Jahr veröffentlichte Filme“ als objecttype: movies releasedafter:2019-1-1 releasedbefore:2019-12-31 interpretiert.
• Wenn die Woche die dritte Märzwoche ist, werden „Filme, die letzte Woche veröffentlicht wurden“ als objecttype: movies releasedafter:2019-3-10 releasedbefore:2019-3-16 interpretiert.
• „Filme mit einer Laufzeit von weniger als 90“ wird als objjecttype: movies runtimelessthan:90 interpretiert.
• Angenommen, das Jahr ist 2019, wird „Filme, die in diesem Jahr veröffentlicht wurden und eine Länge von mehr als 120 Minuten haben“ als releasedafter:2019-1-1 releasedbefore:2019-12-31 objecttype:movies runtimegreaterthan:120 interpretiert.
• Mit „filme nach Veröffentlichungsdatum sortieren“ wird nach „objecttype: movies“ gefiltert und die Ergebnisse werden nach dem Veröffentlichungsdatum sortiert. Die Standardsortierung ist aufsteigend.

Hinweis:In Cloud Search gibt es keinen eigenen Sortieroperator.

Hinweis:Wenn Ihr Schema Operatoren mit denselben Operatorwerten enthält, hängt die Interpretation dieses Werts für einen Operator-Intent in einer Abfrage vom Gesamtkonfidenzfaktor ab, der vom Abfrageinterpretationssystem zurückgegeben wird. Angenommen, Sie haben Schemaattribute für Priorität und Schweregrad mit den Operatoren priority und severity. Angenommen, beide Operatoren können die Werte v0, v1, v2 oder v3 haben. In diesem Beispiel kann sich „v0“ in einer Abfrage auf den Operatorwert für priority oder severity beziehen. Daher ist „v0“ mehrdeutig und daher das Konfidenzniveau niedriger.

Interpretation reservierter Operatoren aktivieren

Sie können auch die reservierten integrierten Operatoren type, before, after und objecttype verwenden, um die Interpretation von Abfragen zu verbessern. Gehen Sie so vor, wenn Sie ein Dokument indexieren möchten:

1. Füllen Sie das Feld updateTime in ItemMetadata, um die Operatoren before und after zu verwenden. Mit diesen Einstellungen kann Cloud Search die folgenden Suchanfragen interpretieren:

   • Bei "Filme von letzter Woche" werden alle Filme aufgelistet, die im Index der Vorwoche aktualisiert wurden.
   • Mit „filme vor jan 2019“ werden alle Filme aufgelistet, die vor Januar 2019 indexiert wurden.

2. Fülle das Feld mimeType im ItemMetadata aus, um die automatische Typerkennung zu verwenden. Bei der Abfrage „Actionvideos“ werden alle Dokumente mit dem Mime-Typ application/mp4, application/mpeg4, application/x-shockwave-flash, video/ und application/vnd.google-apps.video aufgelistet.

Einschränkungen bei der Abfrageauswertung

Die Funktion zur Abfrageauswertung weist die folgenden Einschränkungen auf:

• Die Abfrageauswertung funktioniert nur für die folgenden ACLs für Datenquellen:
  • Alle Dokumente sind öffentlich für die Domain (alle Nutzer in der Domain können darauf zugreifen).
  • Alle Dokumente sind öffentlich zugänglich (alle Nutzer, die Zugriff auf die ACL der Datenquelle haben).
  • Die meisten Dokumente in der Datenquelle haben dieselbe ACL (alle Dokumente übernehmen die ACL desselben Containerelements), ohne dass zusätzliche Leser definiert sind.
• Wenn mehrere Schemaoperatoren denselben Wert haben, hängt die Interpretation dieses Werts für einen Operator-Intent für eine Abfrage vom Gesamtkonfidenzfaktor ab, der vom Abfrageinterpretationssystem zurückgegeben wird. Angenommen, Sie haben die Attribute priority und severity mit denselben im Schema definierten Operatornamen. Angenommen, beide Operatoren können die Werte 0, 1, 2 oder 3 haben. In diesem Beispiel kann „0“ in einer Abfrage auf den Operatorwert für priority oder severity verweisen. Diese Werte sind mehrdeutig und der Konfidenzgrad ist niedriger.
• Standardmäßig werden bei der Abfrageauswertung in Cloud Search Feldwerte in Kleinbuchstaben geschrieben, mit Ausnahme von Textoperatoren, die mit exactMatchWithOperator-Optionen definiert sind.
• Der Operator source wird in Abfragen nicht unterstützt.
• Abfragen, die operatorbasierte Begriffe und Begriffe aus dem freien Text kombinieren, werden nicht interpretiert. Die Suchanfrage „p0 priority cases severity:s0“ wird beispielsweise nicht unterstützt, da „p0 priority cases“ ein kostenloser Textbegriff ist, während „severity:s0“ ein operatorbasierter Begriff ist.
• Bei der Strategie zur Abfrageinterpretation werden die interpretierten Ergebnisse immer mit normalen (nicht interpretierten, nach Relevanz sortierten) Ergebnissen kombiniert. Die Ergebnisse werden nicht ganzseitig ersetzt.