Document the YQL labeled() query operator - #4842
Merged
Merged
Conversation
Vespa 8.743.16 adds labeled(subQuery, "label", score), which wraps an
arbitrary sub-query in a labeled item carrying a raw score. Until now
labels could only be attached with the {label: "..."} annotation, and
there was no way to give a sub-query an explicit score for ranking.
Add a reference entry for the operator in the YQL query operator
table, next to rank(), explaining that the score is exposed to ranking
expressions through itemRawScore(label). The example shows the intended
use: retrieve on the main query with rank(), then let labeled() clauses
contribute boosts without affecting matching, combined them in a rank
profile expression.
kkraune
approved these changes
Aug 24, 2026
kkraune
left a comment
kkraune
left a comment
Member
There was a problem hiding this comment.
great, and the example is useful!
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Vespa 8.743.16 adds labeled(subQuery, "label", score), which wraps an arbitrary sub-query in a labeled item carrying a raw score. Until now labels could only be attached with the {label: "..."} annotation, and there was no way to give a sub-query an explicit score for ranking.
Add a reference entry for the operator in the YQL query operator table, next to rank(), explaining that the score is exposed to ranking expressions through itemRawScore(label). The example shows the intended use: retrieve on the main query with rank(), then let labeled() clauses contribute boosts without affecting matching, combined them in a rank profile expression.