pub struct SelectivityFeedbackManager { /* private fields */ }Expand description
Selective Feedback Manager
Managing selective feedback based on multiple conditions.
§Examples
use linkrs_query::optimizer::stats::feedback::selectivity::SelectivityFeedbackManager;
let manager = SelectivityFeedbackManager::new();
manager.register_condition("age > 25".to_string(), 0.3);
let corrected = manager.get_corrected_selectivity("age > 25");
assert!(corrected.is_some());Implementations§
Source§impl SelectivityFeedbackManager
impl SelectivityFeedbackManager
Sourcepub fn with_params(alpha: f64, min_correction: f64, max_correction: f64) -> Self
pub fn with_params(alpha: f64, min_correction: f64, max_correction: f64) -> Self
Created using custom parameters
Sourcepub fn register_condition(&self, key: String, estimated_selectivity: f64)
pub fn register_condition(&self, key: String, estimated_selectivity: f64)
Selective estimation of registration requirements
Registers the condition only when the key is not present yet, so repeated estimation of the same predicate does not reset previously learned corrections.
Sourcepub fn refresh_estimated(&self, key: &str, estimated_selectivity: f64) -> bool
pub fn refresh_estimated(&self, key: &str, estimated_selectivity: f64) -> bool
Update the baseline estimate of a registered condition while preserving its learned correction factor, so baselines track fresh statistics instead of freezing at first sight. Returns false when the key is unknown.
Sourcepub fn get_corrected_selectivity(&self, key: &str) -> Option<f64>
pub fn get_corrected_selectivity(&self, key: &str) -> Option<f64>
Getting corrected selectivity
Sourcepub fn snapshot(&self) -> SelectivitySnapshot
pub fn snapshot(&self) -> SelectivitySnapshot
Capture an immutable snapshot of the current learned corrections for one planning decision to read through without mutating shared state.
Sourcepub fn update_feedback(&self, key: &str, actual_selectivity: f64) -> bool
pub fn update_feedback(&self, key: &str, actual_selectivity: f64) -> bool
Update feedback
Sourcepub fn update_feedback_ratio(&self, key: &str, ratio: f64) -> bool
pub fn update_feedback_ratio(&self, key: &str, ratio: f64) -> bool
Update feedback from an estimated-vs-actual row ratio.
The ratio is the correction factor actual_rows / estimated_rows;
returns false when the key has not been registered.
Sourcepub fn update_measured_ratio(
&self,
key: &str,
ratio: f64,
input_rows: u64,
) -> bool
pub fn update_measured_ratio( &self, key: &str, ratio: f64, input_rows: u64, ) -> bool
Update feedback from a measured local-parameter ratio over a known number of input rows (the feedback loop’s write path).
Returns false when the key has not been registered; staged
outliers still return true (the sample was recorded, just not
applied yet).
Sourcepub fn remove_feedback_by_space(&self, space_prefix: &str) -> usize
pub fn remove_feedback_by_space(&self, space_prefix: &str) -> usize
Remove all feedback whose key starts with space_prefix (e.g.
"myspace:"), returning the number of removed entries.
Sourcepub fn update_feedback_batch(&self, updates: &[(String, f64)])
pub fn update_feedback_batch(&self, updates: &[(String, f64)])
Batch Update Feedback
Sourcepub fn get_feedback(&self, key: &str) -> Option<FeedbackDrivenSelectivity>
pub fn get_feedback(&self, key: &str) -> Option<FeedbackDrivenSelectivity>
Obtain feedback information
Sourcepub fn get_all_keys(&self) -> Vec<String>
pub fn get_all_keys(&self) -> Vec<String>
Obtain all feedback keys.
Sourcepub fn remove_feedback(&self, key: &str) -> Option<FeedbackDrivenSelectivity>
pub fn remove_feedback(&self, key: &str) -> Option<FeedbackDrivenSelectivity>
Remove feedback that meets specific criteria.
Sourcepub fn feedback_count(&self) -> usize
pub fn feedback_count(&self) -> usize
Number of feedback requests received
Sourcepub fn set_default_params(
&mut self,
alpha: f64,
min_correction: f64,
max_correction: f64,
)
pub fn set_default_params( &mut self, alpha: f64, min_correction: f64, max_correction: f64, )
Set default parameters
Trait Implementations§
Source§impl Clone for SelectivityFeedbackManager
impl Clone for SelectivityFeedbackManager
Source§impl Debug for SelectivityFeedbackManager
impl Debug for SelectivityFeedbackManager
Auto Trait Implementations§
impl !Freeze for SelectivityFeedbackManager
impl !RefUnwindSafe for SelectivityFeedbackManager
impl Send for SelectivityFeedbackManager
impl Sync for SelectivityFeedbackManager
impl Unpin for SelectivityFeedbackManager
impl UnsafeUnpin for SelectivityFeedbackManager
impl UnwindSafe for SelectivityFeedbackManager
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> FmtForward for T
impl<T> FmtForward for T
Source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self to use its Binary implementation when Debug-formatted.Source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self to use its Display implementation when
Debug-formatted.Source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self to use its LowerExp implementation when
Debug-formatted.Source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self to use its LowerHex implementation when
Debug-formatted.Source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self to use its Octal implementation when Debug-formatted.Source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self to use its Pointer implementation when
Debug-formatted.Source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self to use its UpperExp implementation when
Debug-formatted.Source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self to use its UpperHex implementation when
Debug-formatted.Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
Source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
Source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
Source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self, then passes self.as_ref() into the pipe function.Source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self, then passes self.as_mut() into the pipe
function.Source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self, then passes self.deref() into the pipe function.Source§impl<T> Pointable for T
impl<T> Pointable for T
impl<T> Read<Exclusive, BecauseExclusive> for Twhere
T: ?Sized,
Source§impl<T> Tap for T
impl<T> Tap for T
Source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B> of a value. Read moreSource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B> of a value. Read moreSource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R> view of a value. Read moreSource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R> view of a value. Read moreSource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap() only in debug builds, and is erased in release builds.Source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut() only in debug builds, and is erased in release
builds.Source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref() only in debug builds, and is erased in release
builds.Source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut() only in debug builds, and is erased in release
builds.Source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref() only in debug builds, and is erased in release
builds.