Expand description
Redis 客户端、分布式锁、管线、发布订阅和分区消费基础层。
分区消费通过 Redis 租约与 PEL 完成持久接管,由实例独占的 napart Runner 集合执行业务键有序任务。 本地调度支持 source、group、stream 隔离,跨执行域的同计划同业务键仍保持顺序屏障。 成功业务与 ACK 分离,未知确认保留提交责任;源级总预算覆盖读取、执行、重试和发布, group/stream 将消费容量划为固定域份额,跨域不借用;发布仍使用源级独立预算。 正常停机报告未收敛时可以继续等待同一操作,显式强停才请求有损中止。
业务通常通过 nasa::redis 门面接入;本 crate 承载单点/集群 Redis 的类型化命令、
连接治理和分布式协作能力。
§普通消费与命令微批
Stream、共享组 Proxy 与 AutoPipeline 各自持有可等待的关闭 owner,也可交给 Application
按命名计划管理。Service 的消费与发送入口和宿主终端共用启动许可,关键任务责任在发布前
受本地状态保护;Batch 仅支持命名 Pipeline。普通 Stream 组模式的 on_success 在 handler
失败时保留 PEL,不自动重投;Proxy 清理必须有完整 pending 证据,排干与清理共用截止点。
它们不提供分区消费的业务键顺序。
受管微批限制已接纳命令参数字节,单批软上限 B 与单命令上限 M 给出 B+M 的保守边界, 不包含响应、编码和等待调用者的内存。未知写入结果不会自动重放;取消等待不等于任务已经退出。 本地处理次数与任务存活不证明远端 PEL、业务成功或 Redis 可达。
Re-exports§
pub use client::RedisClient;pub use client::RedisRegistry;pub use codec::Json;pub use commands::KeyTtl;pub use config::CompatibilityProfile;pub use config::PartitionGroupCfg;pub use config::RedisConfig;pub use error::NasaRedisError;pub use idempotent::IdempotentCounterCfg;pub use idempotent::IdempotentCounterError;pub use idempotent::IdempotentCounterSnapshot;pub use idempotent::IdempotentPipelineSession;pub use idempotent::IdempotentRejection;pub use idempotent::IdempotentTicket;pub use idempotent::IdempotentTtlMode;pub use error::Result;pub use keytag::effective_tag;pub use keytag::redis_slot;pub use keytag::synthetic_tag;pub use leader::Leader;pub use lock::DistributedLock;pub use lock::HoldStatus;pub use lock::LockGuard;pub use partition::compat_double_to_string;pub use partition::compat_long_hash;pub use partition::compat_string_hash;pub use partition::route_i64;pub use partition::route_str;pub use partition::ExecutionDomainSnapshot;pub use partition::PartitionExecutorCfg;pub use partition::PartitionExecutorScope;pub use partition::PartitionLimits;pub use partition::PartitionRecord;pub use partition::PartitionShutdownReport;pub use partition::PartitionSnapshot;pub use partition::PreparedPartition;pub use partition::PublisherSnapshot;pub use partition::RecordIdentity;pub use partition::RunningPartition;pub use pipeline::AutoPipeline;pub use pipeline::MicroBatchCfg;pub use pipeline::PipelineSession;pub use pipeline::Ticket;pub use proxy::PreparedProxy;pub use proxy::ProxyCfg;pub use proxy::ProxyPoison;pub use proxy::ProxyStartOffset;pub use proxy::RunningProxy;pub use pubsub::Message;pub use pubsub::Subscription;pub use snowflake::SnowflakeConfig;pub use snowflake::WorkerIdLease;pub use stream::StreamAckPolicy;pub use stream::StreamEntry;pub use stream::StreamEnvelope;pub use stream::StreamEvent;pub use stream::StreamField;pub use stream::StreamGroupStart;pub use stream::StreamMode;pub use stream::StreamPublishItem;pub use stream::StreamStart;pub use stream::StreamSubscribeCfg;pub use stream::StreamSubscriber;pub use stream::StreamSubscription;pub use stream::StreamTypedEvent;pub use stream::STREAM_EVENT;
Modules§
- client
- Redis 连接建立、拓扑识别和统一执行入口。
- codec
- Redis 值序列化包装类型。
- commands
- 类型化 Redis 命令集合。 类型化 Redis 命令层,统一计时、连接与错误语义。
- config
- Redis 连接、命令、锁、stream 和 partition 配置。
- error
- Redis 组件统一错误类型。
- idempotent
- nonce 幂等计数:String/Hash/ZSet 计数的 nonce 窗口幂等,账本身份为稳定线协议。 nonce 幂等计数:为 String、Hash、ZSet 计数提供 nonce 窗口幂等,一段 Lua 同时完成判重、计数与凭证登记。
- keytag
- Redis Cluster hash tag 与 slot 计算工具。 按 Redis 字节级 hash tag 规则计算 Cluster slot,并为任意源键派生同槽辅助键。
- leader
- 基于分布式锁的 leader 选举辅助。 基于 DistributedLock 的 Redis 租约选举;持有约定锁的节点在本地发布领导权。
- lock
- Redis 分布式锁与本地重入守卫。
- partition
- 基于 Redis Stream 的分区消费、重平衡和处置控制。 Redis Stream 分区消费:来源租约、不可变计划、业务键顺序与独立确认责任。
- pipeline
- 显式 pipeline、typed ticket 和自动微批管线。
- proxy
- Redis Stream 代理消费运行时。
- pubsub
- Redis pub/sub 订阅和发布封装。
- snowflake
- 雪花 ID 生成器:纯算法
Snowflake与显式初始化、永久不复用 workerId 的 Redis 账本。 Snowflake workerId 的显式分配边界。 - stream
- 普通 stream(event-field wire)的 publish/subscribe。
Structs§
- Redis
Command - 自动微批调用使用的 Redis 命令与类型化响应转换合同。 Represents redis commands.
- Redis
Task Observation - 当前领域 owner 的本地责任快照;各数量不代表 Redis 的持久消息总数。
- Snowflake
- 纯本地雪花 ID 生成器。
Enums§
- Snowflake
Error - 雪花生成器错误。
Traits§
- From
Redis Value - 自动微批调用使用的 Redis 命令与类型化响应转换合同。 This trait is used to convert a redis value into a more appropriate type.