SuperAPI AI 工具集

upstash-redis

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:@upstash/redis 通过 HTTPS 而非 TCP 连接 Upstash Redis,每条命令都是无状态 HTTP 请求,适用于 Vercel、Netlify Functions、Cloudflare Workers、Deno、Bun 和 Next.js 中间件等难以维持持久 TCP 连接的环境。客户端自动序列化与反序列化 JavaScript 值。

主要能力:可将 Redis 命令作为小写方法调用(get、set、hset、zadd、incr);支持缓存旁路、TTL 过期、管道批量命令。示例:const redis = Redis.fromEnv(); redis.set(user:${id}, user, { ex: 3600 }); 管道用 redis.pipeline() 将独立命令合并为一次往返,非原子;事务需用 redis.multi() 或 Lua 脚本。

使用方式:在 Upstash 控制台创建数据库,将 REST URL 与令牌写入环境变量 UPSTASH_REDIS_REST_URL、UPSTASH_REDIS_REST_TOKEN,用 Redis.fromEnv() 读取。Cloudflare Workers 从 @upstash/redis/cloudflare 导入并传入 env。

适用场景:无服务器或边缘函数中的缓存、会话存储、计数器、排行榜、简单队列。

限制:仅支持 Upstash Redis,无法连接自托管或其他 Redis;每条命令为 HTTP 请求,延迟高于热 TCP 连接;multi() 遇运行时错误不回滚,REST 不支持 WATCH;不支持 Pub/Sub 订阅和阻塞命令;本技能仅覆盖 TypeScript 客户端。REST 令牌拥有完整读写权限,须保存在服务端环境变量,切勿下发到浏览器;只读工作负载应使用只读令牌;flushdb 和 del 等破坏性命令在生产库执行前需向用户确认。