SuperAPI AI 工具集

vercel-kv

前端与建站

查看项目

更新于 10-15 22:39

技能介绍

用途:Vercel KV 是 Vercel 平台上由 Upstash 提供、兼容 Redis 的键值存储,用于在 Next.js 及其他 Vercel 应用中做缓存、计数、会话、限流等临时数据存储。

主要能力:通过 @vercel/kv 客户端提供 set/get、setex、exists、del、incr/decr、incrby、setnx、mget/mset、expire、pipeline 批量执行,以及 zadd/zrange/zrevrank 等有序集合操作。值会自动 JSON 序列化,不存在的键返回 null,操作具备原子性,TTL 以秒为单位。

使用方式:在 Vercel 项目 Storage 中创建 KV 数据库,运行 vercel env pull .env.local 获取 KV_REST_API_URL、KV_REST_API_TOKEN 等变量;安装 npm install @vercel/kv 后在 Server Action 或 Edge API Route 中导入 { kv } 使用。生产环境变量由 Vercel 自动注入。

适用场景:缓存旁路、写穿缓存、会话管理、速率限制、分布式锁、排行榜、浏览量计数等。

限制与注意:免费额度为每月 30,000 条命令、256MB 存储;KV 默认不加密、不适合作为主数据库或存储关键持久数据;单值建议小于 100KB,超过 1MB 应改用 Vercel Blob;临时数据应设置 TTL,键名应使用命名空间避免冲突;只存可 JSON 序列化数据,避免函数、BigInt、循环引用;.env.local 不应提交到版本库。

资料未提供具体价格、SLA 细节及更多平台支持信息。