更新时间:2025-04-14 GMT+08:00

创建存储仓

操作场景

本章节指导用户在KVS管理控制台创建存储仓,同时创建一个表并指定索引。

约束与限制

  • 存储仓的名称长度范围为16-52个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”组成,“-”不能出现在名字头部或尾部。仓名称全域唯一,不同租户的仓名不能相同。存储仓的命名规范为{用户自定义前缀}-{当前控制台所在区域的区域名}-{账号ID} ,例如:exampleprefix-cn-north-4-exampledomainid。
  • 为存储仓命名时字母大小写不敏感。例如,KVS已存在存储仓exampleprefix-cn-north-4-exampledomainid,如果您再创建存储仓Exampleprefix-cn-north-4-exampledomainid,系统会认定为同一种仓名,导致创建存储仓失败。
  • 单个账号支持创建的存储仓数量不超过25个。

操作步骤

  1. 进入KVS管理控制台。
  2. 在KVS管理控制台左侧导航栏选择“仓”。
  3. 在页面右上角单击“创建仓”。
  4. 根据界面提示,配置“仓详细信息”参数,如表1所示。

    图1 “仓详细信息”界面

    表1 “仓详细信息”参数说明

    类别

    参数名称

    描述

    仓详细信息

    仓名称

    必选参数。

    存储仓的名称。存储仓的名称长度范围为16-52个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”组成,“-”不能出现在名字头部或尾部。仓名称全域唯一,不同租户的仓名不能相同。

    存储仓的命名规范为{用户自定义前缀}-{当前控制台所在区域的区域名}-{账号ID} 。

    须知:

    区域名和账号ID为仓名称的固定部分,用户只需填写自定义前缀部分。

  5. 根据界面提示,选择“基础配置>计费模式”,如表2所示。

    图2 “基础配置”界面

    表2 “基础配置”参数说明

    类别

    参数名称

    描述

    基础配置

    按需计费

    后付费模式。按需计费模式适用于业务流量未知或者变化较大的场景。

    预置计费

    后付费模式。预置计费模式适用于业务流量稳定或者可预测的场景。

  6. 根据界面提示,配置“表详细信息”参数,如表3所示。

    图3 “表详细信息”界面

    表3 “表详细信息”参数说明

    类别

    参数名称

    描述

    表详细信息

    表名称

    必选参数。

    表的名称。表的名称长度范围为3-52个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成,且表名称在存储仓内唯一。

    分区键

    必选参数。

    分区键的长度范围为1-63个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成首字母不支持设置为“_”

    排序键

    可选参数。

    排序键的长度范围为1-63个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成首字母不支持设置为“_”

  7. (可选)计费模式为“预置计费”时展示该步骤。根据界面提示,配置“预置读/写吞吐量”,如表4所示。

    主表的预置读/写吞吐量根据KV平均大小、每秒读/写的KV数 、本地二级索引平均大小、每秒读/写的本地二级索引数决定。

    单击“吞吐量计算器”,在右侧弹出的图5中输入各个参数值,可得到预期的预置读/写吞吐量作为参考,参数详情请参见表5。参数填写完成后单击“确定”,“读取吞吐量”和“写入吞吐量”的数值可自动导入图4中的“读取吞吐量”和“写入吞吐量”中。

    图4 “预置读/写吞吐量”界面

    图5 “吞吐量计算器”弹窗界面

    表4 “预置读/写吞吐量”参数说明

    类别

    参数名称

    描述

    预置读/写吞吐量

    读取吞吐量

    • 输入范围:1-50000,单位:RCU。
      说明:

      每个用户在每个区域内支持的最大读取吞吐量:100000RCU。

    • 读取吞吐量 = RoundUp(KV平均大小(KB)/4) * 每秒读取的KV数 + RoundUp(本地二级索引平均大小(KB)/4) * 每秒读取的本地二级索引数,RoundUp为向上取整函数。

    写入吞吐量

    • 输入范围:1-50000,单位:WCU。
      说明:

      每个用户在每个区域内支持的最大写入吞吐量:100000WCU。

    • 写入吞吐量 = RoundUp(KV平均大小(KB)/1) * 每秒写入的KV数 + RoundUp(本地二级索引平均大小(KB)/1) * 每秒写入的本地二级索引数,RoundUp为向上取整函数。
    表5 “吞吐量计算器”参数说明

    参数

    示例

    描述

    KV平均大小

    100

    • 输入不能为空。
    • 请输入预置的KV平均大小,单位:KB。

    每秒读取的KV数

    10

    • 输入不能为空。
    • 请输入预置的每秒读取的KV数。

    每秒写入的KV数

    10

    • 输入不能为空。
    • 请输入预置的每秒写入的KV数。

    本地二级索引平均大小

    100

    • 输入不能为空。
    • 请输入预置的本地二级索引平均大小,单位:KB。

    每秒读取的本地二级索引数

    10

    • 输入不能为空。
    • 请输入预置的每秒读取的本地二级索引数。

    每秒写入的本地二级索引数

    10

    • 输入不能为空。
    • 请输入预置的每秒写入的本地二级索引数。

    读取吞吐量

    500RCU

    • 自动计算出数值,单位:RCU。
    • 计算公式:读取吞吐量 = RoundUp(KV平均大小(KB)/4) * 每秒读取的KV数 + RoundUp(本地二级索引平均大小(KB)/4) * 每秒读取的本地二级索引数,RoundUp为向上取整函数。

    写入吞吐量

    2000WCU

    • 自动计算出数值,单位:WCU。
    • 计算公式:写入吞吐量 = RoundUp(KV平均大小(KB)/1) * 每秒写入的KV数 + RoundUp(本地二级索引平均大小(KB)/1) * 每秒写入的本地二级索引数,RoundUp为向上取整函数。

  8. 根据界面提示,配置“二级索引”。支持创建本地二级索引和全局二级索引。

    1. 单击“创建本地二级索引”,配置参数信息如表6所示。确认配置信息后单击“确定”。
      图6 “创建本地二级索引”界面

      表6 “创建本地二级索引”参数说明

      类别

      参数名称

      描述

      创建本地二级索引

      名称

      必选参数。

      本地二级索引的名称。名称的长度范围为1-255个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”、“.”组成。名称不支持设置XPriIndex

      排序键

      必选参数。

      排序键的长度范围为1-63个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成首字母不支持设置为“_”

      摘要字段

      可选参数。

      本地二级索引的摘要字段。支持创建多个摘要。摘要的长度范围为1-63个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成首字母不支持设置为“_”

    2. 单击“创建全局二级索引”,配置参数信息如表7所示。确认配置信息后单击“确定”。
      图7 “创建全局二级索引”界面

      表7 “创建全局二级索引”参数说明

      类别

      参数名称

      描述

      创建全局二级索引

      名称

      必选参数。

      全局二级索引的名称。名称的长度范围为1-255个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”“.”组成名称不支持设置XPriIndex

      分区键

      必选参数。

      分区键的长度范围为1-63个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成首字母不支持设置为“_”

      排序键

      可选参数。

      排序键的长度范围为1-63个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成首字母不支持设置为“_”

      读取吞吐量

      输入范围:1-50000,单位:RCU。仅在预置计费模式下展示该字段并生效。

      写入吞吐量

      输入范围:1-50000,单位:WCU。仅在预置计费模式下展示该字段并生效。

      摘要字段

      可选参数。

      全局二级索引的摘要字段。支持创建多个摘要。摘要的长度范围为1-63个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成。首字母不支持设置为“_”

  9. 信息设置完成后,单击“确定”。