• 产品简介
  • 快速开始
    • 导入 Git 仓库
    • 从模板开始
    • 直接上传
    • 从 AI 开始
  • 框架指南
    • 前端
    • 后端
    • 全栈
      • Next.js
      • Nuxt
      • Astro
      • React Router
      • SvelteKit
    • 自定义 404 页面
  • 项目指南
    • 项目管理
    • edgeone.json
    • 缓存配置
    • 错误码
  • 构建指南
  • 部署指南
    • 概览
    • 触发部署
    • 管理部署
    • 部署按钮
    • 使用 Github Action
    • 使用 CNB 插件
    • 使用 IDE 插件
    • 使用 CodeBuddy IDE
  • 域名管理
    • 概览
    • 自定义域名
    • 配置 HTTPS 证书
      • 概览
      • 申请免费证书
      • 使用 SSL 托管证书
    • 配置 DNS 的 CNAME 记录
  • 可观测性
    • 概览
    • 指标分析
    • 日志分析
  • Pages Functions
    • 概览
    • Edge Functions
    • Cloud Functions
      • 概览
      • Node Functions
  • KV 存储
  • 边缘 AI
  • API Token
  • EdgeOne CLI
  • Pages MCP
  • 集成指南
    • AI
      • 对话型大模型集成
      • 图片大模型集成
    • 数据库
      • Supabase 集成
      • Pages KV 集成
    • 电商
      • Shopify 集成
      • WooCommerce 集成
    • 支付
      • Stripe 集成
      • Paddle 集成
    • CMS
      • WordPress 集成
      • Contentful 集成
      • Sanity 集成
    • 身份验证
      • Supabase 集成
      • Clerk 集成
  • 最佳实践
    • 使用通用大模型快速搭建 AI 应用
    • 使用边缘 AI 模型快速搭建对话型 AI 站点
    • 使用 Shopify 搭建电商平台
    • 使用 Supabase 和 Stripe 搭建 SaaS 站点
    • 如何快速搭建公司品牌站点
    • 如何快速搭建博客站点
  • 迁移指南
    • 从 Vercel 迁移至 EdgeOne Pages
    • 从 Cloudflare Pages 迁移至 EdgeOne Pages
    • 从 Netlify 迁移至 EdgeOne Pages
  • 排障指南
  • 常见问题
  • 联系我们
  • 产品动态

Pages KV 集成

Pages KV 存储可用于静态站点动态功能增强、轻量级数据存储、无服务器应用支持、数据缓存,和传统的数据库相比更适合读多写少的场景,作为一种轻量级的存储方案。


快速入门

如果是第一次使用 Pages 的 KV 存储服务,建议使用我们提供的模版来尝试。整体操作步骤包含三步:开通 KV 存储服务、Pages 项目关联 KV 空间、在项目中使用 KV 存储,下面将详细介绍相关内容。


开通 Pages KV 服务

进入 Pages 控制台,在头部导航栏中点击KV Storage,点击Apply now开始开通。

申请开通KV存储服务需完成以下步骤:

1. 填写申请理由 - 请根据您的实际业务需求详细描述使用场景和目的
2. 提交申请 - 完成申请表后,点击 Submit 按钮正式提交审核
3. 等待审批 - 系统将通知相关工作人员进行评估和处理

如您有比较紧急的开发需求,可以联系管理人员处理。


4. 创建命名空间
服务开通成功后,点击控制台中的 Create Namespace 选项
为命名空间指定一个具有业务意义的名称
点击确认完成创建

5. 初始化KV存储
导航至 Data Management 数据管理区域
点击 Create Record 开始配置键值对数据
按业务需求设置键名(Key)和对应值(Value)
完成所有必要字段配置后提交

提示:KV存储初始化完成后,即可通过API进行数据读写操作。建议提前规划好键名命名规范和数据存储结构。


创建 Pages 项目,并关联 KV 存储

1、部署 Pages KV 模版

在控制台 Pages Project 页面,点击 Create project -> Start from template。在左侧导航栏中找到 Database -> Pages KV,选择
Pages functions for KV 模版。

打开模版,在部署页面直接点击 Create,部署大致会花费二十秒左右,在部署前如果没有关联线上 Git 的需要完成 Git 授权(支持 Github/Gitee)。


2、给 Pages 项目绑定 Namespace

部署完成后在左侧导航栏中点击 KV Storage,在页面中点击 Bind Namespace

在 Bind Namespace 窗口中,选择之前申请开通的 KV 服务中创建的 Namespace,然后填入 Variable NameVariable Name将会在代码中使用,用于访问 Namespace 中的变量。


3、在代码中实现 KV 操作

具体使用方式可以查看 Pages functions for KV 模版代码中的 /functions/visit/index.js,以下是一个简单的请求访问示例。
// 获取变量
const visitCount = await my_kv.get('visitCount');
let visitCountInt = Number(visitCount);
visitCountInt += 1;

//修改变量
await my_kv.put('visitCount', visitCountInt.toString());

const res = JSON.stringify({
visitCount: visitCountInt,
});
更详细的信息可以访问操作文档查看。


本地开发

EdgeOne CLI 为开发者提供了强大的命令行界面工具,能够显著提升您的开发效率与代码质量。通过这一工具,您可以:

直观操作各项边缘计算功能,简化配置流程
高效调试代码:在本地环境中实时检测和优化代码表现
线上数据同步:轻松将生产环境数据引入本地开发环境,确保测试真实可靠
精准问题定位:快速识别并解决边缘计算中的性能瓶颈

无论您是经验丰富的开发者还是刚接触边缘计算的新手,EdgeOne CLI都能帮助您构建更稳定、更高效的应用。深入了解更多高级功能与最佳实践,请访问我们的操作文档


更多相关内容

了解 EdgeOne CLI 的使用:EdgeOne CLI 使用说明
了解 KV Storage:KV Storage 使用文档
了解更多的边缘函数使用:边缘函数使用文档

ai-agent
你可以这样问我
如何开始使用 EdgeOne Pages?