evaluate-Methodeevaluate Method

Die evaluate-Methode wertet die Ausgabe eines strukturierten Abfrageausdrucks basierend auf den Indexdaten aus und gibt diese zurück.The evaluate method evaluates and returns the output of a structured query expression based on the index data.

Ein Ausdruck wird in der Regel von einer Antwort auf die interpret-Methode abgerufen.Typically, an expression will be obtained from a response to the interpret method. Sie können jedoch auch selbst Abfrageausdrücke erstellen (siehe Strukturierter Abfrageausdruck).But you can also compose query expressions yourself (see Structured Query Expression).

AnforderungRequest

http://<host>/evaluate?expr=<expr>&attributes=<attrs>[&<options>]

NAMEName WertValue BESCHREIBUNGDescription
exprexpr TextzeichenfolgeText string Strukturierter Abfrageausdruck, der eine Teilmenge von Indexentitäten auswählt.Structured query expression that selects a subset of index entities.
attributesattributes TextzeichenfolgeText string Durch Trennzeichen getrennte Liste von Attributen, die in der Antwort enthalten sein sollen.Comma-delimited list of attributes to include in response.
countcount Zahl (default=10)Number (default=10) Maximale Anzahl der zurückzugebenden Ergebnisse.Maximum number of results to return.
offsetoffset Zahl (default=0)Number (default=0) Index des ersten zurückzugebenden Ergebnisses.Index of the first result to return.
orderbyorderby TextzeichenfolgeText string Name des Attributs, mit dem die Ergebnisse sortiert werden, gefolgt von einer optionalen Sortierreihenfolge (default=asc): „attrname[:(asc|desc)]“.Name of attribute used to sort the results, followed by optional sort order (default=asc): "attrname[:(asc|desc)]". Wenn kein Attribut angegeben wird, werden die Ergebnisse durch Verringern der Wahrscheinlichkeit natürlicher Logarithmen zurückgegeben.If not specified, the results are returned by decreasing natural log probability.
timeouttimeout Zahl (default=1000)Number (default=1000) Timeout in Millisekunden.Timeout in milliseconds. Nur die vor Ablauf des Timeouts berechneten Ergebnisse werden zurückgegeben.Only results computed before the timeout has elapsed are returned.

Mithilfe der Parameter count und offset kann eine große Anzahl von Ergebnissen inkrementell über mehrere Anforderungen abgerufen werden.Using the count and offset parameters, a large number of results may be obtained incrementally over multiple requests.

Antwort (JSON)Response (JSON)

JSONPathJSONPath BESCHREIBUNGDescription
$.expr$.expr expr-Parameter aus der Anforderung.expr parameter from the request.
$.entities$.entities Array mit 0 oder mehr Objektentitäten, die dem strukturierten Abfrageausdruck entsprechen.Array of 0 or more object entities matching the structured query expression.
$.aborted$.aborted „true“, wenn ein Timeout bei der Anforderung aufgetreten ist.True if the request timed out.

Jede Entität enthält einen logprob-Wert und die Werte der angeforderten Attribute.Each entity contains a logprob value and the values of the requested attributes.

BeispielExample

Im Beispiel der wissenschaftlichen Veröffentlichungen übergibt die folgende Anforderung einen strukturierten Abfrageausdruck (möglicherweise aus der Ausgabe einer interpret-Anforderung) und ruft einige Attribute für die ersten zwei übereinstimmenden Entitäten ab:In the academic publications example, the following request passes a structured query expression (potentially from the output of an interpret request) and retrieves a few attributes for the top 2 matching entities:

http://<host>/evaluate?expr=Composite(Author.Name=='jaime teevan')&attributes=Title,Y,Author.Name,Author.Id&count=2

Die Antwort enthält die ersten zwei („count=2“) übereinstimmenden Entitäten mit der höchsten Wahrscheinlichkeit.The response contains the top 2 ("count=2") most likely matching entities. Für jede Entität werden Attribute zu Titel, Jahr, Name des Autors und Autor-ID zurückgegeben.For each entity, the title, year, author name, and author ID attributes are returned. Beachten Sie, dass die Struktur der kombinierten Attributwerte der Art und Weise entspricht, wie sie in der Datendatei angegeben werden.Note how the structure of composite attribute values matches the way they are specified in the data file.

{
  "expr": "Composite(Author.Name=='jaime teevan')",
  "entities": 
  [
    {
      "logprob": -6.645,
      "Ti": "personalizing search via automated analysis of interests and activities",
      "Y": 2005,
      "Author": [
        {
          "Name": "jaime teevan",
          "Id": 1968481722
        },
        {
          "Name": "susan t dumais",
          "Id": 676500258
        },
        {
          "Name": "eric horvitz",
          "Id": 1470530979
        }
      ]
    },
    {
      "logprob": -6.764,
      "Ti": "the perfect search engine is not enough a study of orienteering behavior in directed search",
      "Y": 2004,
      "Author": [
        {
          "Name": "jaime teevan",
          "Id": 1982462162
        },
        {
          "Name": "christine alvarado",
          "Id": 2163512453
        },
        {
          "Name": "mark s ackerman",
          "Id": 2055132526
        },
        {
          "Name": "david r karger",
          "Id": 2012534293
        }
      ]
    }
  ]
}