1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
// Sonic
//
// Fast, lightweight and schema-less search backend
// Copyright: 2019, Valerian Saliou <valerian@valeriansaliou.name>
// Copyright: 2026, Rémi Bardon <remi@remibardon.name>
// License: Mozilla Public License v2.0 (MPL v2.0)
use linked_hash_set::LinkedHashSet;
use std::iter::FromIterator;
use crate::lexer::TokenLexer;
use crate::query::{QuerySearchID, QuerySearchLimit, QuerySearchOffset};
use crate::store::StoreItem;
use crate::store::fst::StoreFSTActionBuilder;
use crate::store::identifiers::{StoreObjectIID, StoreTermHash};
use crate::store::kv::{StoreKVAcquireMode, StoreKVActionBuilder};
impl super::Executor {
pub fn search(
&self,
item: StoreItem,
_event_id: QuerySearchID,
lexer: TokenLexer,
limit: QuerySearchLimit,
offset: QuerySearchOffset,
) -> Result<Vec<String>, ()> {
if let StoreItem(collection, Some(bucket), None) = item {
// Important: acquire database access read lock, and reference it in context. This \
// prevents the database from being erased while using it in this block.
let _kv_read_guard = self.kv_pool.lock_read_access();
let _fst_read_guard = self.fst_pool.lock_read_access();
if let (Ok(kv_store), Ok(fst_store)) = (
self.kv_pool
.acquire(StoreKVAcquireMode::OpenOnly, collection),
self.fst_pool.acquire(collection, bucket),
) {
// Important: acquire bucket store read lock
executor_kv_lock_read!(kv_store);
let (kv_action, fst_action) = (
StoreKVActionBuilder::access(bucket, kv_store),
StoreFSTActionBuilder::access(fst_store),
);
// Try to resolve existing search terms to IIDs, and perform an algebraic AND on \
// all resulting IIDs for each given term.
let mut found_iids: LinkedHashSet<StoreObjectIID> = LinkedHashSet::new();
'lexing: for (term, term_hashed) in lexer {
let mut iids = LinkedHashSet::from_iter(
kv_action
.get_term_to_iids(term_hashed)
.unwrap_or(None)
.unwrap_or_default(),
);
// No IIDs? Try to complete with a suggested alternate word
// Notice: this may sound dirty to try generating as many results as the \
// 'retain_word_objects' value, but as we do not know if another lexed word \
// comes next we need to exhaust all search space as to intersect it with \
// the (likely) upcoming word.
let (higher_limit, alternates_try) = (
self.app_conf.store.kv.retain_word_objects,
self.app_conf.search.query_alternates_try,
);
if iids.len() < higher_limit && alternates_try > 0 {
tracing::debug!(
"not enough iids were found ({}/{}), completing for term: {}",
iids.len(),
higher_limit,
term
);
// Suggest N words, in case the first one is found in FST as an exact \
// match of term, we can pick next ones to complete search even further.
// Notice: we add '1' to the 'alternates_try' number as to account for \
// exact match suggestion that comes as first result and is to be ignored.
if let Some(suggested_words) =
fst_action.suggest_words(&term, alternates_try + 1, Some(1))
{
let mut iids_new_len = iids.len();
// This loop will be broken early if we get enough results at some \
// iteration
'suggestions: for suggested_word in suggested_words {
// Do not load base results twice for same term as base term
if suggested_word == term {
continue 'suggestions;
}
tracing::debug!(
"got completed word: {} for term: {}",
suggested_word,
term
);
if let Some(suggested_iids) = kv_action
.get_term_to_iids(StoreTermHash::from(&suggested_word))
.unwrap_or(None)
{
for suggested_iid in suggested_iids {
// Do not append the same IID twice (can happen a lot \
// when completing from suggested results that point \
// to the same end-OID)
if !iids.contains(&suggested_iid) {
iids.insert(suggested_iid);
iids_new_len += 1;
// Higher limit now reached? Stop acquiring new \
// suggested IIDs now.
if iids_new_len >= higher_limit {
tracing::debug!(
"got enough completed results for term: {}",
term
);
break 'suggestions;
}
}
}
}
}
tracing::debug!(
"done completing results for term: {}, now {} results",
term,
iids_new_len
);
} else {
tracing::debug!("did not get any completed word for term: {}", term);
}
}
tracing::debug!("got search executor iids: {:?} for term: {}", iids, term);
// Intersect found IIDs with previous batch
if found_iids.is_empty() {
found_iids = iids;
} else {
found_iids = found_iids.intersection(&iids).copied().collect();
}
tracing::debug!(
"got search executor iid intersection: {:?} for term: {}",
found_iids,
term
);
// No IID found? (stop there)
if found_iids.is_empty() {
tracing::info!(
"stop search executor as no iid was found in common for term: {}",
term
);
break 'lexing;
}
}
// Resolve OIDs from IIDs
// Notice: we also proceed paging from there
let (limit_usize, offset_usize) = (limit as usize, offset as usize);
let mut result_oids = Vec::with_capacity(limit_usize);
'paging: for (index, found_iid) in found_iids.iter().skip(offset_usize).enumerate()
{
// Stop there?
if index >= limit_usize {
break 'paging;
}
// Read IID-to-OID for this found IID
if let Ok(Some(oid)) = kv_action.get_iid_to_oid(*found_iid) {
result_oids.push(oid);
} else {
tracing::error!("failed getting search executor iid-to-oid");
}
}
tracing::info!("got search executor final oids: {:?}", result_oids);
return Ok(result_oids);
}
}
Err(())
}
}