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