边缘开发者平台
  • Pages
    • 产品简介
    • 快速开始
      • 导入 Git 仓库
      • 从模板开始
      • 直接上传
    • 框架指南
    • 项目指南
      • 项目管理
      • edgeone.json
      • 缓存配置
      • 错误码
    • 构建指南
    • 部署指南
      • 概览
      • 触发部署
      • 管理部署
      • 部署按钮
      • 使用 Github Action
    • 域名管理
      • 概览
      • 自定义域名
      • 配置 HTTPS 证书
      • 如何配置 DNS 的 CNAME 记录
    • Pages Functions
    • KV 存储
    • 边缘 AI
    • API Token
    • EdgeOne CLI
    • Pages MCP
    • 集成指南
      • 数据库
        • Supabase 集成
        • Pages KV 集成
      • 电商
        • Shopify 集成
        • WooCommerce 集成
      • 支付
        • Stripe 集成
        • Paddle 集成
      • CMS
        • WordPress 集成
        • Contentful 集成
        • Sanity 集成
      • 身份验证
        • Supabase 集成
        • Clerk 集成
    • 最佳实践
      • 使用 Deepseek-R1 模型快速搭建对话型AI站点
      • 使用 WordPress + WooCommerce 和 GatsbyJS 搭建电商平台
      • 使用 Supabase 和 Stripe 搭建 SaaS 站点
      • 如何快速搭建公司品牌站点
      • 如何快速搭建博客站点
    • 迁移指南
      • 从 Vercel 迁移至 EdgeOne Pages
      • 从 Cloudflare Pages 迁移至 EdgeOne Pages
      • 从 Netlify 迁移至 EdgeOne Pages
    • 排障指南
    • 常见问题
    • 联系我们
    • 产品动态
解锁 1年EdgeOne + 1TB CDN: 加入我们的开发者之旅
立即开始!
当前为国际站中文文档,如需访问中国站文档,请点击这里

Pages KV 集成

Pages KV 存储是 EdgeOne 提供的一种强大的分布式键值(Key-Value)存储系统。


概览

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 使用文档
了解更多的边缘函数使用:边缘函数使用文档