Skip to main content

LogQuery

Struct LogQuery 

Source
pub struct LogQuery {
    pub topic_partition: TopicPartition,
    pub terms: Vec<Arc<str>>,
    pub exact_fields: Vec<MetadataField>,
    pub predicate: LogPredicate,
    pub start_offset: Option<LogicalOffset>,
    pub end_offset: Option<LogicalOffset>,
    pub start_timestamp_unix_nanos: Option<u64>,
    pub end_timestamp_unix_nanos: Option<u64>,
    pub limit: Option<usize>,
    pub order: QueryOrder,
    pub sort: QuerySort,
    pub after: Option<QueryCursor>,
}
Expand description

Boolean log lookup against one logical partition.

Fields§

§topic_partition: TopicPartition

Partition to search. Query fan-out is intentionally an explicit higher layer.

§terms: Vec<Arc<str>>

Case-insensitive message terms, combined with AND semantics.

§exact_fields: Vec<MetadataField>

Exact metadata fields, combined with AND semantics.

§predicate: LogPredicate

Additional exact Boolean predicate.

§start_offset: Option<LogicalOffset>

Inclusive lowest durable offset.

§end_offset: Option<LogicalOffset>

Exclusive highest durable offset.

§start_timestamp_unix_nanos: Option<u64>

Inclusive lowest event timestamp in Unix nanoseconds.

§end_timestamp_unix_nanos: Option<u64>

Exclusive highest event timestamp in Unix nanoseconds.

§limit: Option<usize>

Maximum number of records to return.

§order: QueryOrder

Durable-offset result order.

§sort: QuerySort

Stable record sort key.

§after: Option<QueryCursor>

Exclusive continuation point from the previous page.

Implementations§

Source§

impl LogQuery

Source

pub fn matches<R: StructuralRecordView>(&self, record: &R) -> bool

Returns whether a normalized structural record satisfies every lookup range, legacy exact constraint, Boolean predicate, and page cursor.

Source

pub fn compare<R: StructuralRecordView>(&self, left: &R, right: &R) -> Ordering

Compares two matching records in the query’s deterministic result order.

Source

pub fn cursor_for<R: StructuralRecordView>(&self, record: &R) -> QueryCursor

Creates the stable continuation point represented by one result.

Source

pub fn select<R: StructuralRecordView>( &self, records: impl IntoIterator<Item = R>, ) -> Vec<R>

Applies exact residual filtering, deterministic ordering, and the result limit to decoded candidate records from a sealed-block lookup.

Source

pub fn requires_post_decode(&self) -> bool

Returns whether sealed candidates require record decoding before the query can be limited safely.

Callers serving sealed blocks should stream these queries block by block instead of materializing the complete candidate set.

Source§

impl LogQuery

Source

pub fn new(topic_partition: TopicPartition) -> Self

Creates an empty query for a logical partition.

Source

pub fn with_term(self, term: impl Into<Arc<str>>) -> Self

Adds a case-insensitive exact token constraint.

Source

pub fn with_field( self, key: impl Into<Arc<str>>, value: impl Into<Arc<str>>, ) -> Self

Adds an exact metadata constraint.

Source

pub fn with_predicate(self, predicate: LogPredicate) -> Self

Adds an arbitrary predicate with AND semantics.

Source

pub fn where_predicate(self, predicate: LogPredicate) -> Self

Replaces the additional Boolean predicate.

Source

pub fn with_offset_range(self, start: LogicalOffset, end: LogicalOffset) -> Self

Restricts results to start..end durable offsets.

Source

pub fn with_timestamp_range(self, start: u64, end: u64) -> Self

Restricts results to start..end event timestamps.

Source

pub fn with_limit(self, limit: usize) -> Self

Caps the number of materialized results.

Source

pub fn newest_first(self) -> Self

Returns the highest durable offsets first.

Source

pub fn oldest_first(self) -> Self

Returns the lowest sort keys first.

Source

pub fn sort_by_timestamp(self) -> Self

Sorts by event timestamp with durable offset as the tie-breaker.

Source

pub fn sort_by_offset(self) -> Self

Sorts by durable logical offset.

Source

pub fn after(self, cursor: QueryCursor) -> Self

Continues strictly after a previous page’s final record in query order.

Trait Implementations§

Source§

impl Clone for LogQuery

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for LogQuery

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Eq for LogQuery

Source§

impl PartialEq for LogQuery

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for LogQuery

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Allocation for T
where T: RefUnwindSafe + Send + Sync,

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> FromRef<T> for T
where T: Clone,

Source§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
Source§

impl<T> FutureExt for T

Source§

fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
Source§

fn with_current_context(self) -> WithContext<Self> ⓘ

Attaches the current Context to this type, returning a WithContext wrapper. Read more
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts 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 more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts 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 more
Source§

impl<T> IntoRequest<T> for T

Source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
Source§

impl<L> LayerExt<L> for L

Source§

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in Layered.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more