Struct ShardingApi 

pub struct ShardingApi;

ShardingApi

Implementations

impl ShardingApi

pub fn lookup_partition_key( pool: &str, partition_key: &str, ) -> Option<Principal>

Lookup the shard assigned to a partition_key in a pool, if any.

pub fn resolve_shard_for_key( pool: &str, partition_key: impl AsRef<str>, ) -> Result<Principal, Error>

Return the shard for a partition_key, or an Error if unassigned.

pub fn registry() -> ShardingRegistryResponse

Return a view of the full sharding registry.

pub fn partition_keys( pool: &str, shard: Principal, ) -> ShardingPartitionKeysResponse

Return all partition_keys currently assigned to a shard.

pub async fn assign_to_pool( pool: &str, partition_key: impl AsRef<str>, ) -> Result<Principal, Error>

Assign a partition_key to a shard in the given pool.

pub fn plan_assign_to_pool( pool: &str, partition_key: impl AsRef<str>, ) -> Result<ShardingPlanStateResponse, Error>

Perform a dry-run shard assignment and return the resulting plan.