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

创建表

操作场景

本章节指导用户在指定存储仓创建表,同时指定索引。

前提条件

已成功创建要创建表的存储仓。

约束与限制

  • 单个存储仓下可以创建的表数量不超过100个。
  • 一个表一定归属于某个存储仓。
  • 一个主表仅支持创建1个分区键和1个排序键。
  • 表的名称长度范围为3-52个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成,且表的名称在存储仓内唯一。
  • 为表命名时字母大小写敏感。例如,某存储仓内已存在表exampletable,如果您再创建表ExampleTable,系统会认定为不同的表名,可以成功创建表。

操作步骤

  1. 登录KVS管理控制台。
  2. 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。
  3. 在仓列表中找到需要创建表的仓,在仓对应的操作列,单击“创建表”,或者单击仓名称进入仓的详情页面,在“表信息”下单击“创建表”。
  4. 根据界面提示,选择“基础配置>计费模式”,如表1所示。

    图1 “基础配置”界面

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

    类别

    参数名称

    描述

    基础配置

    按需计费

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

    预置计费

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

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

    图2 “表详细信息”界面
    表2 “表详细信息”参数说明

    类别

    参数名称

    描述

    表详细信息

    表名称

    必选参数。

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

    分区键

    必选参数。

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

    排序键

    可选参数。

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

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

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

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

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

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

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

    类别

    参数名称

    描述

    预置读/写吞吐量

    读取吞吐量

    • 输入范围: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为向上取整函数。
    表4 “吞吐量计算器”参数说明

    参数

    示例

    描述

    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为向上取整函数。

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

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

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

      类别

      参数名称

      描述

      创建本地二级索引

      名称

      必选参数。

      本地二级索引的名称。名称的长度范围为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. 单击“创建全局二级索引”,配置参数信息如表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,及特殊符“-”、“_”组成首字母不支持设置为“_”

      读取吞吐量

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

      写入吞吐量

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

      摘要字段

      可选参数。

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

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