Struct PartitionKey 

pub struct PartitionKey { /* private fields */ }

Partition key for distributing events across fixed partitions

SierraDB uses 32 fixed partitions for single-node, 1024+ for clusters. We start with 32 for single-node deployment, ready for clustering.

Invariants

• Partition count is fixed at construction (default: 32)
• Partition ID is always in range [0, partition_count)
• Same entity always maps to same partition (consistent hashing)

Implementations

impl PartitionKey

pub const DEFAULT_PARTITION_COUNT: u32 = 32u32

Default partition count (SierraDB uses 32 for single-node)

pub fn from_entity_id(entity_id: &str) -> Self

Create a partition key from an entity ID

Uses consistent hashing to ensure same entity always maps to same partition. This is critical for ordering guarantees within a partition.

pub fn from_entity_id_with_count(entity_id: &str, partition_count: u32) -> Self

Create a partition key with custom partition count

pub fn from_partition_id( partition_id: u32, partition_count: u32, ) -> Result<Self>

Create from explicit partition ID (for reconstruction)

pub fn partition_id(&self) -> u32

Get partition ID

pub fn partition_count(&self) -> u32

Get partition count

pub fn belongs_to_node(&self, node_id: u32, total_nodes: u32) -> bool

Check if this partition belongs to a specific node (for clustering)

Trait Implementations

impl Clone for PartitionKey

fn clone(&self) -> PartitionKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartitionKey

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PartitionKey

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PartitionKey

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

Formats the value using the given formatter.

impl PartialEq for PartitionKey

fn eq(&self, other: &PartitionKey) -> 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 Serialize for PartitionKey

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for PartitionKey

impl Eq for PartitionKey

impl StructuralPartialEq for PartitionKey