Struct Range 

#[non_exhaustive]
pub struct Range {
    pub start_key: Bytes,
    pub limit_key: Bytes,
    pub group_uid: u64,
    pub split_id: u64,
    pub generation: Bytes,
    /* private fields */
}

A Range represents a range of keys in a database. The keys themselves are encoded in “sortable string format”, also known as ssformat. Consult Spanner’s open source client libraries for details on the encoding.

Each range represents a contiguous range of rows, possibly from multiple tables/indexes. Each range is associated with a single paxos group (known as a “group” throughout this API), a split (which names the exact range within the group), and a generation that can be used to determine whether a given Range represents a newer or older location for the key range.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

start_key: Bytes

The start key of the range, inclusive. Encoded in “sortable string format” (ssformat).

limit_key: Bytes

The limit key of the range, exclusive. Encoded in “sortable string format” (ssformat).

group_uid: u64

The UID of the paxos group where this range is stored. UIDs are unique within the database. References Group.group_uid.

split_id: u64

A group can store multiple ranges of keys. Each key range is named by an ID (the split ID). Within a group, split IDs are unique. The split_id names the exact split in group_uid where this range is stored.

generation: Bytes

generation indicates the freshness of the range information contained in this proto. Generations can be compared lexicographically; if generation A is greater than generation B, then the Range corresponding to A is newer than the Range corresponding to B, and should be used preferentially.

Implementations

impl Range

pub fn new() -> Self

Creates a new default instance.

pub fn set_start_key<T: Into<Bytes>>(self, v: T) -> Self

Sets the value of start_key.

pub fn set_limit_key<T: Into<Bytes>>(self, v: T) -> Self

Sets the value of limit_key.

pub fn set_group_uid<T: Into<u64>>(self, v: T) -> Self

Sets the value of group_uid.

pub fn set_split_id<T: Into<u64>>(self, v: T) -> Self

Sets the value of split_id.

pub fn set_generation<T: Into<Bytes>>(self, v: T) -> Self

Sets the value of generation.

Trait Implementations

impl Clone for Range

fn clone(&self) -> Range

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Range

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

Formats the value using the given formatter.

impl Default for Range

fn default() -> Range

Returns the “default value” for a type.

impl Message for Range

fn typename() -> &'static str

The typename of this message.

impl PartialEq for Range

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Range