本教程基于简单的示例场景介绍如何在边缘函数中使用边缘 KV。
边缘 KV 服务是在 BytePlus 的全球边缘节点上的分布式键值存储服务。一个键值对通过边缘函数控制台、OpenAPI 或运行时 API 被写入边缘 KV 后，会自动被同步到所有边缘节点。函数通过运行时 API 可以快速读取位于同一边缘节点的键值对。

示例场景 #

您的网站支持 A/B 测试功能，可以根据用户的地理位置返回不同版本的网页。版本切换的配置信息存储在边缘 KV 中。您希望可以从函数的代码中读取版本切换的配置信息。在本教程中，假设配置信息如下：

{
  "us": "versionA",
  "eu": "versionB",
  "asia": "versionA"
}

操作步骤 #

您需要完成以下步骤实现示例场景。

1. 创建一个存储空间。
2. 在存储空间中创建一个键值对。
3. 在函数代码中读取键值对的值。

步骤一：创建一个存储空间 #

参见以下步骤创建一个存储空间。

1. 打开 边缘KV 页面。
2. 在 边缘KV 页面，点击 创建存储空间。

3. 在 创建存储空间 对话框中，设置以下参数，然后点击 保存 。

步骤二：在存储空间中创建一个键值对 #

参见以下步骤在存储空间中创建一个键值对。
您可以使用控制台、OpenAPI 或运行时 API 创建键值对。

1. 打开 边缘KV 页面。
2. 找到您创建的 abtest_config 存储空间，点击该存储空间的名称。
3. 点击 添加数据。
4. 在弹出的 添加数据 对话框中，设置数据的相关参数，然后点击 保存。

步骤三：在函数代码中读取键值对的值。 #

参见以下步骤在函数代码中读取键值对的值。

在函数代码中，您调用 KV.get() 获取键值对的值。

const config = await KV.get("abtest_config","config_key",{type:"string"});