Bug 23875

Summary: Elasticsearch - When sorting by score we should provide a tiebreaker
Product: Koha Reporter: Nick Clemens (kidclamp) <nick>
Component: Searching - ElasticsearchAssignee: Nick Clemens (kidclamp) <nick>
Status: Needs Signoff --- QA Contact:
Severity: normal    
Priority: P5 - low CC: alex.arnaud, ere.maijala, fridolin.somers, glasklas, jonathan.druart, kyle, martin.renvoize, severine.queune
Version: Main   
Hardware: All   
OS: All   
See Also: https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30879
Change sponsored?: --- Patch complexity: Trivial patch
Documentation contact: Documentation submission:
Text to go in the release notes:
Version(s) released in:
Circulation function:
Bug Depends on: 23089    
Bug Blocks:    
Attachments: Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker
Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker
Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker
Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker

Description Nick Clemens (kidclamp) 2019-10-22 14:39:21 UTC
In ES if we sort by 'relevance' we actually don't pass anything to ES and results are ordered by score.

When doing a search limiting only by collection or type, the scores are all the same. This is fine, except that editing any record will then cause a reordering of the results, even though it won't affect the score.

We should provide a tie-breaker in the case of equal sort scores
Comment 1 Nick Clemens (kidclamp) 2019-10-22 14:43:08 UTC
Created attachment 94579 [details] [review]
Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker

To test:
 1 - Set search engine to ES
 2 - Search the catalog for "*"
 3 - Note results
 4 - Edit first result
 5 - Repeat search, results are reordered
 6 - Apply patch
 7 - Search for "*"
 8 - Highest biblionumbers are returned first
 9 - Edit first result, repeat search
10 - Order does not change
11 - Confirm sorting by author, title, etc passes the same trials
Comment 2 Ere Maijala 2019-10-23 14:08:43 UTC
Should we care that the sorting by local-number.raw isn't numeric?
Comment 3 Nick Clemens (kidclamp) 2019-10-24 10:23:09 UTC
(In reply to Ere Maijala from comment #2)
> Should we care that the sorting by local-number.raw isn't numeric?

In the mappings local-number is set as a string by default - should we change it to a number? I think in practice it will be a number, however, under ES at least I don't see why someone couldn't map local-number to 001 and manage their own control numbers with letters, so maybe string is okay as long as your numbers are built consistently?
Comment 4 Ere Maijala 2019-10-25 06:35:15 UTC
Created attachment 94712 [details] [review]
Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker

To test:
 1 - Set search engine to ES
 2 - Search the catalog for "*"
 3 - Note results
 4 - Edit first result
 5 - Repeat search, results are reordered
 6 - Apply patch
 7 - Search for "*"
 8 - Highest biblionumbers are returned first
 9 - Edit first result, repeat search
10 - Order does not change
11 - Confirm sorting by author, title, etc passes the same trials

Signed-off-by: Ere Maijala <ere.maijala@helsinki.fi>
Comment 5 Ere Maijala 2019-10-25 06:41:14 UTC
(In reply to Nick Clemens from comment #3)
> In the mappings local-number is set as a string by default - should we
> change it to a number? I think in practice it will be a number, however,
> under ES at least I don't see why someone couldn't map local-number to 001
> and manage their own control numbers with letters, so maybe string is okay
> as long as your numbers are built consistently?

Changing it to number would be scary, and I don't think this is really an issue. If we want to make sorting consistent, we could always left-pad the biblionumber with zeros, but I don't really like it since it wouldn't match the biblionumber field in MARC exactly. Alternatively we could have a hardcoded mapping to a numeric biblionumber field. Or make the tie-breaker sort field configurable. But since local-number gives us consistent results, I believe this is good enough for all practical purposes.
Comment 6 Katrin Fischer 2019-10-27 14:19:10 UTC
(In reply to Ere Maijala from comment #5)
> (In reply to Nick Clemens from comment #3)
> > In the mappings local-number is set as a string by default - should we
> > change it to a number? I think in practice it will be a number, however,
> > under ES at least I don't see why someone couldn't map local-number to 001
> > and manage their own control numbers with letters, so maybe string is okay
> > as long as your numbers are built consistently?
> 
> Changing it to number would be scary, and I don't think this is really an
> issue. If we want to make sorting consistent, we could always left-pad the
> biblionumber with zeros, but I don't really like it since it wouldn't match
> the biblionumber field in MARC exactly. Alternatively we could have a
> hardcoded mapping to a numeric biblionumber field. Or make the tie-breaker
> sort field configurable. But since local-number gives us consistent results,
> I believe this is good enough for all practical purposes.

I am not sure if I understand the issue compeletely, but why would local-number be scary as a number? local-number is usually the biblionumber, right? And if it is, I am in doubt about what Nick says that you could just remap it to 001 - at least I would expect issues with that.

I think being able to sort numerical on biblionumber is important so you can use it as a tie breaker as mentioned before, when all other criteria are the some. You you can sort from newer to older.

If we don't sort numerical... that meanst 9 999 2 22 1 11 ... something like that?
Comment 7 Ere Maijala 2019-10-28 07:12:58 UTC
(In reply to Katrin Fischer from comment #6)
> I am not sure if I understand the issue compeletely, but why would
> local-number be scary as a number? local-number is usually the biblionumber,
> right? And if it is, I am in doubt about what Nick says that you could just
> remap it to 001 - at least I would expect issues with that.

Yes, it's usually biblionumber, but there's nothing preventing one from e.g. adding other fields in it too. Unless we hard-code a field for biblionumber, we can't positively say it's always a number.

> If we don't sort numerical... that meanst 9 999 2 22 1 11 ... something like
> that?

Yes.
Comment 8 Katrin Fischer 2019-10-28 07:15:03 UTC
(In reply to Ere Maijala from comment #7)
> (In reply to Katrin Fischer from comment #6)
> > I am not sure if I understand the issue compeletely, but why would
> > local-number be scary as a number? local-number is usually the biblionumber,
> > right? And if it is, I am in doubt about what Nick says that you could just
> > remap it to 001 - at least I would expect issues with that.
> 
> Yes, it's usually biblionumber, but there's nothing preventing one from e.g.
> adding other fields in it too. Unless we hard-code a field for biblionumber,
> we can't positively say it's always a number.
> 
> > If we don't sort numerical... that meanst 9 999 2 22 1 11 ... something like
> > that?
> 
> Yes.

Maybe we should have an unchangeable index for biblionumber then? The sorting could quickly become an issue. People tend to search very 'broadly' and then the tie breaker would come in quickly. At least that's what we see with Zebra quite often with searches for single words and similar.
Comment 9 Ere Maijala 2019-10-28 07:19:03 UTC
(In reply to Katrin Fischer from comment #8)
> Maybe we should have an unchangeable index for biblionumber then? The
> sorting could quickly become an issue. People tend to search very 'broadly'
> and then the tie breaker would come in quickly. At least that's what we see
> with Zebra quite often with searches for single words and similar.

Using non-numeric sort doesn't really matter for tie-breaker unless you care for the order. I'd actually like us to have a hard-coded biblionumber index field. One could also argue that biblionumber should only be the last resort, and publication date should be the primary. We'll probably end up making it configurable. ;)
Comment 10 Katrin Fischer 2019-10-28 07:25:16 UTC
And by the reasoning that we can't prevent other fields being added... doesn't that apply to all other indexes as well? Would Elastic give you an error when searching on a string in a numerical index or just not sort them 'right'?(In reply to Ere Maijala from comment #9)
> (In reply to Katrin Fischer from comment #8)
> > Maybe we should have an unchangeable index for biblionumber then? The
> > sorting could quickly become an issue. People tend to search very 'broadly'
> > and then the tie breaker would come in quickly. At least that's what we see
> > with Zebra quite often with searches for single words and similar.
> 
> Using non-numeric sort doesn't really matter for tie-breaker unless you care
> for the order. I'd actually like us to have a hard-coded biblionumber index
> field. One could also argue that biblionumber should only be the last
> resort, and publication date should be the primary. We'll probably end up
> making it configurable. ;)

publication date can get quickly problematic for serials... the first date in 008 is usually quite old. Every approach has its own problems ;)

Maybe we can move the discussion of adding a hardcoded biblionumber index into another bug, but it really bugs me that the sorting of a clearly numerical value would be alphabetic... it just seems very wrong. I've ended up explaining the 'last resort' ordering a lot of times to libraries.
Comment 11 Ere Maijala 2019-10-28 08:02:19 UTC
(In reply to Katrin Fischer from comment #10)
> publication date can get quickly problematic for serials... the first date
> in 008 is usually quite old. Every approach has its own problems ;)

True, and I didn't mean to imply that should be a default. :)

> Maybe we can move the discussion of adding a hardcoded biblionumber index
> into another bug, but it really bugs me that the sorting of a clearly
> numerical value would be alphabetic... it just seems very wrong. I've ended
> up explaining the 'last resort' ordering a lot of times to libraries.

I'm fine either way. But clearly at least a follow-up to this bug is needed.
Comment 12 Martin Renvoize (ashimema) 2020-03-11 14:10:48 UTC
Are you intending on continuing here with the requested followup Nick?

I think the suggestion was to have a fixed biblionumber index which is numeric and use that for the tie-breaker by default.. as aposed to using the existing 'local-number' index which can be re-mapped?
Comment 13 Katrin Fischer 2020-08-16 09:36:10 UTC
Patch no longer applies, please rebase!

Apply? [(y)es, (n)o, (i)nteractive] y
Applying: Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker
error: sha1 information is lacking or useless (Koha/SearchEngine/Elasticsearch/QueryBuilder.pm).
error: could not build fake ancestor
Patch failed at 0001 Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker
The copy of the patch that failed is found in: .git/rebase-apply/patch
When you have resolved this problem run "git bz apply --continue".
If you would prefer to skip this patch, instead run "git bz apply --skip".
To restore the original branch and stop patching run "git bz apply --abort".
Patch left in /tmp/Bug-23875-Explicitly-srt-searches-by-score-and-pro-n_vYDq.patch
Comment 14 Nick Clemens (kidclamp) 2020-08-17 11:14:53 UTC
Created attachment 108391 [details] [review]
Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker

To test:
 1 - Set search engine to ES
 2 - Search the catalog for "*"
 3 - Note results
 4 - Edit first result
 5 - Repeat search, results are reordered
 6 - Apply patch
 7 - Search for "*"
 8 - Highest biblionumbers are returned first
 9 - Edit first result, repeat search
10 - Order does not change
11 - Confirm sorting by author, title, etc passes the same trials

Signed-off-by: Ere Maijala <ere.maijala@helsinki.fi>
Comment 15 Katrin Fischer 2020-08-22 22:06:24 UTC
(In reply to Martin Renvoize from comment #12)
> Are you intending on continuing here with the requested followup Nick?
> 
> I think the suggestion was to have a fixed biblionumber index which is
> numeric and use that for the tie-breaker by default.. as aposed to using the
> existing 'local-number' index which can be re-mapped?

I really believe we should do that and have a numerical sort on the biblionumber as a tiebreaker. 

I hear your argument about remapping local-number, but I believe that this is a concern that needs more work and thinking overall if we want to officially support it. At the moment, doing that, would probably break your Zebra pretty badly and now allow to switch back and forth easily anymore.

Having a numerical sort on biblionumber on the tiebreaker would also mimick Zebra a bit allowing to compare relevance sort results more easily.
Comment 16 Fridolin Somers 2022-01-25 10:41:39 UTC
What a strange bug.
Any updates ?
Comment 17 Fridolin Somers 2023-10-02 18:34:27 UTC
30879
Comment 18 Fridolin Somers 2023-10-02 18:35:39 UTC
Ah I had issues with local-number sort, found Bug 30879
Comment 19 Katrin Fischer 2023-12-09 12:06:18 UTC
I believe we have solved the numerical sorting by now - could this be revived?
Comment 20 Fridolin Somers 2024-02-08 16:03:34 UTC
isnt it possible to sort on '_id' (ES document id) instead of local-number ?
Comment 21 Fridolin Somers 2024-02-08 16:05:28 UTC
(In reply to Fridolin Somers from comment #20)
> isnt it possible to sort on '_id' (ES document id) instead of local-number ?

Ah there seems to be a performance issue with sorting on '_id', bad idea ;)
Comment 22 Nick Clemens (kidclamp) 2024-11-07 13:36:12 UTC
Created attachment 174227 [details] [review]
Bug 23875: Explicitly srt searches by score and provide local-number as tie breaker

To test:
 1 - Set search engine to ES
 2 - Search the catalog for "*"
 3 - Note results
 4 - Edit first result
 5 - Repeat search, results are reordered
 6 - Apply patch
 7 - Search for "*"
 8 - Highest biblionumbers are returned first
 9 - Edit first result, repeat search
10 - Order does not change
11 - Confirm sorting by author, title, etc passes the same trials
Comment 23 Nick Clemens (kidclamp) 2024-11-07 13:38:01 UTC
We turned local-number into a number on bug 30879, can we move this one again?