通过控制台使用宽表模型

步骤一：开通表格存储服务

如果已经开通表格存储服务，请跳过此操作。服务仅需开通一次，开通过程免费。

1. 登录表格存储产品详情页。

2. 单击立即开通。

3. 在表格存储页面，仔细阅读协议后选中我已阅读并同意表格存储服务协议后，单击立即开通。

   开通服务后，单击管理控制台，进入表格存储控制台界面。

   您也可以单击阿里云官网首页右上方的控制台，进入阿里云管理控制台首页，单击图标，在导航栏中选择产品与服务 > 存储 > 基础存储服务 > 表格存储TableStore，进入表格存储控制台界面。

步骤二：创建实例

实例是表格存储资源管理的基础单元，表格存储对应用程序的访问控制和资源计量均在实例级别完成。创建实例后，您可以在实例中创建和管理表。

1. 登录表格存储控制台。

2. 在页面上方，选择资源组和地域。

3. 单击创建实例。

4. 在购买方式对话框中，根据实际情况选择计费模式。

   表格存储提供VCU模式（原预留模式）和CU模式（原按量模式）两种实例模型。

   说明

   关于计费模式的区别，请参见VCU模式和CU模式的区别。关于实例命名规则以及如何选择实例规格，请参见实例。

   • VCU模式（原预留模式）：按照资源评估结果预先购买预留VCU或开启弹性能力后按实际使用量支付计算性能消耗费用。您可以叠加使用预留VCU和弹性能力来节约成本。

     此模式能为用户节省更多的计算资源支付费用。同时此模式也通过配置弹性能力上限或关闭弹性能力保障整体使用资源可控，避免异常流量导致的额外费用，是对于成本可控场景的更优选择。

   • CU模式（原按量模式）：根据业务的实时读写吞吐量、存储空间等资源计费，无需提前规划硬件资源消耗。此模式适用于业务峰谷变化较大，不可预测的场景。

   重要

   实例规格在实例创建后无法修改，请谨慎选择。

   单个阿里云账户最多可以创建10个实例，且在同一地域中实例名称必须唯一。

   购买VCU模式实例

   1. 在VCU模式（原预留模式）页签，单击前往购买，根据下表说明购买并配置表格存储标准实例后，单击立即购买。

      参数	描述
      商品类型	只支持VCU模式（预留模式）。
      地域	实例所属地域。
      预留VCU	使用VCU模式（原预留模式）时，所有的计算资源均通过VCU进行定义。1 VCU相当于4核16 GB的处理能力。关于评估选型的更多信息，请参见资源预估选型。 根据预估资源，选择购买的预留VCU个数。取值范围为0~1000。 当预留VCU取值为0时，购买的实例无需预付费，但是您必须为实例开启弹性能力。 为实例开启弹性能力后，表格存储会根据实际的VCU使用量收取费用。购买实例时，表格存储会为实例配置默认弹性上限值。默认弹性上限值为Max(3*预留VCU， 5+预留VCU)。购买实例后，您可以在实例详情页调整实例弹性上限。具体操作，请参见如何调整实例的弹性上限？。 当预留VCU取值不为0时，购买的实例需要预付费，您还可以根据需要为实例开启或关闭弹性能力。 如果未为实例开启弹性能力，则后续在实例中进行操作时，最多只能使用预留VCU对应的计算资源。 您也可以在创建实例后为实例开启弹性能力。具体操作，请参见如何为实例开启弹性能力？。 如果为实例开启了弹性能力，则后续在实例中进行操作时，最多能使用实例弹性上限对应的计算资源。 说明 您可以根据实际需要调整实例的弹性上限。具体操作，请参见如何调整实例的弹性上限？。 当实际业务中的计算资源消耗未超过预留VCU对应的计算资源时，表格存储不会额外收取计算部分费用；当实际业务中的计算资源消耗超过预留VCU对应的计算资源时，表格存储会按照实际使用的VCU弹性部分收取相应费用。
      弹性能力	是否为实例开启弹性能力。取值范围如下： 重要 当预留VCU配置为0时，您必须为实例开启弹性能力。 启用：为实例开启弹性能力。开启弹性能力后，实例弹性上限为弹性能力与预留VCU之和。您可以根据需要调整实例的弹性上限配置。具体操作，请参见如何调整实例的弹性上限？。 不启用：不开启弹性能力。业务最多可用的计算资源对应于购买的预留VCU。
      存储类型	根据业务场景选择合适的存储类型。 容量型：适合写多读少、读取延迟不敏感、海量数据低成本存储场景。 高性能：适合对于读取延迟敏感的业务，提供极低的延迟以及高稳定性保障。
      实例名称	由系统自动生成，无需手动设置。
      实例别名	控制台显示的实例名称。如果未设置，则实例别名和系统生成的实例名称相同。
      实例描述	实例的描述信息，例如实例用途等。
      资源组	实例所属资源组，默认值为默认资源组。如果已有资源组不满足使用需求，您可以单击创建资源组进行资源组创建。
      标签	如果您有大量Tablestore实例，可以通过绑定标签的方式，对实例进行分类管理。更多信息，请参见标签概述。
      购买时长	购买实例的时长。

   2. 在确认订单页面，确认参数配置并仔细阅读服务协议后，选中我已阅读并同意表格存储标准实例服务协议。

   3. 单击去支付，根据系统提示完成订单支付。

   4. 支付完成后，单击管理控制台，进入表格存储控制台界面。

   创建CU模式实例

   1. 在CU模式（原按量模式）页签，选择资源组，输入实例名称，然后选择实例规格，根据业务需求填写实例注释。

   2. 如果您有大量Tablestore实例，可以通过绑定标签的方式，对实例进行分类管理。更多信息，请参见标签概述。

   3. 如果要修改允许访问实例的网络类型或者允许来源，请打开高级选项开关并配置相应参数。

      参数	说明
      允许网络	允许使用何种网络类型访问表格存储资源，支持一次选择多种网络类型。取值范围如下： VPC：是否支持通过VPC访问。默认选中VPC，表示支持通过VPC访问。 如果不需要通过VPC访问，请取消选中VPC。 公网：是否支持通过互联网访问。默认选中公网，表示支持通过互联网访问。 如果不需要通过互联网访问，请取消选中公网。 经典网：是否支持通过经典网络访问。默认选中经典网，表示支持通过经典网络访问。 如果不需要通过经典网访问，请取消选中经典网。
      允许来源	是否允许使用控制台访问表格存储资源。默认选中可信网关(控制台)，表示支持使用控制台访问。 如果不需要使用控制台访问，请取消选中可信网关(控制台)。

   4. 单击确定。

步骤三：创建数据表

创建数据表后，您可以在数据表中读写数据。创建数据表时，您可以根据业务需求同时创建二级索引用于读取数据。

1. 在概览页面，单击实例名称或在操作列单击实例管理。

2. 在实例详情页签，单击创建数据表。

   说明

   单个实例最多可以创建64张数据表。

3. 在创建数据表对话框，按照下表说明配置相关参数。

   参数	描述
   数据表名称	数据表名称，用于在实例中唯一标识一张数据表。 数据表的命名规则为由大小写字母、数字或下划线（_）组成，且只能以字母或下划线（_）开头，长度在1个~255个字节之间。
   表主键	表中的一列或多列，用于唯一标识表中的一条记录。 输入表主键名称并选择数据类型，单击添加表主键，可加入新的主键。 单表最多可设置4个主键，第一个主键默认为分区键。主键的配置及顺序设置后不能修改。 重要 表格存储支持将主键列设置为自增列，每张表只能设置一个主键列为自增列，且分区键不能设置为自增列。 主键列设置为自增列后，在写入一行数据时，该主键列无需填值，表格存储会自动生成该主键列的值。自动生成的主键列的值在分区键内严格递增且唯一。 表主键名称的命名规则为由大小写字母、数字或下划线（_）组成，且只能以字母或下划线（_）开头，长度在1个~255个字节之间。 主键的数据类型可选为字符串、整型或二进制。
   是否允许更新	是否允许通过UpdateRow更新写入数据。默认值为是，表示允许通过UpdateRow更新写入数据。 当要使用多元索引生命周期功能时，您必须设置此参数为否，即不允许通过UpdateRow更新写入数据。关于多元索引生命周期的更多信息，请参见生命周期管理。
   是否加密	是否开启数据落盘加密。系统默认未开启数据落盘加密功能。打开是否加密开关，即可开启数据落盘加密功能。 重要 数据落盘加密功能开启后不支持关闭，请谨慎操作。
   加密类型	数据的加密类型。只有打开是否加密开关时，需要配置该选项。取值范围如下： kms服务主密钥：表格存储会自动创建KMS服务主密钥用于数据落盘加解密。 BYOK自定义密钥：表格存储会基于您自定义的密钥进行数据落盘加解密。 重要 使用BYOK自定义密钥的加密类型前，您需要通过KMS控制台创建软件密钥，然后创建自定义角色并配置权限。具体操作，请参见数据加密。
   密钥ID	密钥的ID。只有当加密类型选择BYOK自定义密钥时，需要配置该选项。
   ARN	角色ARN。只有当加密类型选择BYOK自定义密钥时，需要配置该选项。

4. （可选）在创建数据表对话框，进行高级配置或者创建二级索引。

   当需要对数据表设置数据生命周期等高级配置或者创建二级索引时，请执行此步骤。

   配置高级参数

   如果需要管理表中数据的保存时长，您可以指定数据生命周期；如果需要相同主键的多个版本数据，您可以指定最大版本数。更多信息，请参见数据版本和生命周期。

   对于按量模式下的高性能实例，如果要通过预留吞吐量节省成本，您可以指定数据表的预留读吞吐量或写吞吐量。更多信息，请参见预留读/写吞吐量。

   1. 打开高级设置开关。

   2. 根据下表说明配置高级参数。

      参数	描述
      数据生命周期	数据表中数据的保存时间。当数据的保存时间超过设置的数据生命周期时，系统会自动清理超过数据生命周期的数据。单位为秒。 取值：大于等于86400秒（一天）或-1（数据永不过期）。
      最大版本数	数据表中的属性列能够保留数据的最大版本个数。当属性列数据的版本个数超过设置的最大版本数时，系统会自动删除较早版本的数据。 取值必须为非0整数。
      数据有效版本偏差	指定的数据版本号与系统当前时间偏差的允许最大值，单位为秒。有效版本偏差为正整数，可以大于1970-01-01 00:00:00 UTC时间到当前时间的秒数。 只有当写入数据所有列的版本号与写入时时间的差值在数据有效版本偏差范围内，数据才能成功写入。 属性列的有效版本范围为[max{数据写入时间-有效版本偏差,数据写入时间-数据生命周期}，数据写入时间+有效版本偏差)。
      预留读吞吐量	容量型实例不支持该参数。 为数据表预留读吞吐量或写吞吐量。取值范围为0~100000，且取值必须为整数。单位为CU。 当预留读吞吐量或预留写吞吐量大于0时，表格存储会根据配置为数据表分配和预留相应资源，且数据表创建成功后，将会立即按照预留吞吐量开始计费。 当预留读吞吐量或预留写吞吐量为0时，表格存储不会为数据表分配和预留相应资源。
      预留写吞吐量

   配置二级索引

   当某些应用需要使用不同属性作为查询条件来执行数据查询时，您可以通过将这些属性作为二级索引的主键列实现按照属性快速查询数据的需求。更多信息，请参见二级索引介绍。

   1. 打开创建二级索引开关。

   2. 单击添加预定义列，输入预定义列名称和选择数据类型。

      预定义列名称命名规则为由大小写字母、数字或下划线（_）组成，且只能以字母或下划线（_）开头，长度在1个~255个字节。

      预定义列的数据类型可选为字符串、整型、二进制、浮点数或布尔值。

   3. 单击添加二级索引，输入索引名称，选择索引主键，根据需要选择索引预定义列及索引类型。

      重要

      索引名不能与数据表名称相同，索引名和数据表名称均必须在实例中唯一。

      索引名称必须由大小写字母、数字或下划线（_）组成，且只能以字母或下划线（_）开头，长度在1个~255个字节之间。

      • 索引主键可以是数据表主键和预定义列，支持多选；索引预定义列只能从数据表的预定义列中选择，支持多选。但是选择的索引预定义列不能与主键列重复。

      • 索引类型支持选择为全局或者本地。

        重要

        全局二级索引的第一列主键可根据需要选择任意主键列或者预定义列，本地二级索引的第一列主键必须和数据表的第一列主键相同。

        全局二级索引以异步方式将数据表中被索引的列和主键列的数据自动同步到索引表中，正常情况下同步延迟达到毫秒级别；本地二级索引以同步方式将数据表中被索引的列和主键列的数据自动同步到索引表中，当数据写入数据表后，即可从索引表中查询到数据。

5. 单击确定。

   数据表创建完成后，在数据表列表区域，您可以查看已创建的数据表。如果新建的表未显示在列表中，可单击图标，刷新数据表列表。

步骤四：读写数据

在数据表中写入、更新、读取或者删除数据。

1. 在实例详情页签的数据表列表区域，单击数据表名称后选择数据管理页签或在操作列单击查询/搜索。

2. 根据需求进行数据读写。

   插入一行数据

   1. 在数据管理页签，单击插入数据。

   2. 在插入数据对话框，输入主键的值，单击图标，设置属性列名称、属性列类型、属性值和数据版本号。

      系统默认已选中使用系统时间复选框，采用当前系统时间作为数据版本号。您也可以清除使用系统时间复选框输入数据版本号。

   3. 单击确定。

   更新一行数据

   1. 在数据管理页签，选中需要更新的数据行，单击更新数据。

   2. 在更新数据对话框，增加或删除属性列，更新或删除属性列的数据。

      • 单击图标，增加属性列；单击图标，删除属性列。

      • 选择更新操作为更新，修改属性列的数据；选择更新操作为删除，选择需要删除的数据版本号，删除对应数据版本号的数据；选择更新操作为删除全部，删除全部数据版本号的数据。

   3. 单击确定。

   读取数据

   通过控制台您可以读取单行数据或者范围读取数据，请根据实际选择。

   读取单行数据

   1. 在数据管理页签，单击查询数据。

   2. 在查询数据对话框，选择查询范围为单行查询，并选择要查询的表或者二级索引。

   3. 系统默认返回所有列。如需返回指定属性列，关闭获取所有列开关并输入需要返回的属性列，多个属性列之间用半角逗号（,）隔开。

   4. 输入目标行的主键值。

      主键值的完整性和准确性均会影响查询。

   5. 输入最大版本数，指定需要返回的版本数。

   6. 单击确定。

   范围读取数据

   1. 在数据管理页签，单击查询数据。

   2. 在查询数据对话框，选择查询范围为范围查询，并选择要查询的表或者二级索引。

   3. 系统默认返回所有列。如需返回指定属性列，关闭获取所有列开关并输入需要返回的属性列，多个属性列之间用半角逗号（,）隔开。

   4. 输入起始主键列和结束主键列。

   重要

   • 范围查询优先使用第一个主键值进行查询，当设置的第一个主键值一致时，系统会使用第二个主键值进行查询，其他主键的查询规则同上。

   • 读取范围是前开后闭的区间。

   5. 输入最大版本数，指定需要返回的版本数。

   6. 设置查询结果的排序方向，可选正序查询或逆序查询。

   7. 单击确定。

   删除数据

   重要

   删除表数据，将导致数据不可恢复，请谨慎操作。

   1. 在数据管理页签，选中需要删除的数据行，单击批量删除。

   2. 在批量删除对话框，单击确定。

步骤五：使用SQL查询数据

SQL查询兼容MySQL的查询语法，同时提供基础的SQL DDL建表能力。对于已有数据表，通过执行CREATE TABLE一键自动建立映射关系后，您可以使用SQL方式访问表中数据。更多信息，请参见SQL查询。

1. 在概览页面，单击实例名称或在操作列单击实例管理。

2. 在SQL查询页签，创建映射关系。

   1. 单击图标。

      说明

      当不存在映射表时，单击SQL查询页签，系统会自动弹出创建映射表对话框。

      

   2. 在创建映射表对话框中，根据下表说明配置参数。

      参数	描述
      表类型	表类型。取值范围如下： 普通表（默认）：在为数据表创建映射关系时，选择此项。 时序表：在为时序表创建映射关系时，选择此项。
      表名	表名称。
      映射模式	创建映射关系的模式。只有当表类型选择为普通表时才能配置。取值范围如下： 表映射（默认）：为已存在的数据表创建映射关系。 多元索引映射：为已存在的多元索引创建映射关系。
      高级选项	用于配置映射表的一致性模式和是否使用不准确的聚合。打开高级选项开关，即可进行配置。只有当映射模式选择为表映射时才能进行配置。
      一致性模式	执行引擎支持的一致性模式。只有打开了高级选项开关后才能配置。取值范围如下： 最终一致（默认）：执行的查询结果满足最终一致。此时新数据写入后会在几秒后影响到查询结果。 强一致性：执行的查询结果满足强一致性。此时新数据写入后立刻影响到查询结果。
      不准确的聚合	是否允许通过牺牲聚合操作的精准度提升查询性能。只有打开了高级选项开关后才能配置。取值范围如下： 是（默认）：允许通过牺牲聚合操作的精度来提升查询性能。 否：不允许通过牺牲聚合操作的精度提升查询性能
      多元索引表	映射表绑定的多元索引名称。只有当映射模式选择为多元索引映射时才能配置。
      映射表表名	映射表名称。 如果表类型选择为普通表，当映射模式选择为表映射时，映射表表名与数据表名称相同，不能更改；当映射模式选择为多元索引映射时，需要填写映射表名称。 如果表类型选择为时序表，请根据实际填写映射表名称。时序表映射关系创建成功后，系统会自动在映射表名前添加时序表名称::前缀。
      使用分析存储查询	分析存储功能主要用于时序数据长期存储和分析场景。使用分析存储（Analytical Store）功能，您可以低成本存储时序数据以及快速查询和分析时序数据。更多信息，请参见时序分析存储概述。 只有当表类型选择为时序表时才能配置。系统默认关闭使用分析存储查询开关，请根据实际业务场景进行相应配置。 如果不需要使用分析存储来存储与分析时序数据，使用分析存储查询保持默认配置即可。 如果需要低成本存储时序数据以及快速查询和分析时序数据，请确保已创建分析存储并打开使用分析存储查询开关。 重要 如果创建了使用分析存储查询的SQL映射表，则在删除分析存储时，您需要同时删除分析存储SQL映射表。否则会导致删除分析存储失败。

   3. 单击生成SQL。

      系统会自动生成创建映射表的SQL语句。SQL示例如下：

      CREATE TABLE `exampletable` (
          `id` BIGINT(20),
          `colvalue` MEDIUMTEXT,
          `content` MEDIUMTEXT,
          PRIMARY KEY(`id`)
      );

      重要

      请确保映射关系中字段数据类型和数据表中字段数据类型相匹配。关于数据类型映射的更多信息，请参见SQL数据类型映射。

   4. 根据实际需要修改映射表的Schema后，按住鼠标左键拖动选中一条SQL语句并单击执行SQL(F8)。

      执行成功后，在执行结果区域会显示执行结果。

      重要

      • 创建映射表时设置的Schema中需要包括后续查询数据所需的列。

      • 执行SQL语句时，请选中一条所需SQL语句，否则系统默认执行第一条SQL语句。

      • 执行SQL语句时，一次只能选中一条SQL语句，否则系统会报错。

      

3. 执行SELECT语句查询所需数据。更多信息，请参见查询数据。

常见问题

• 表格存储和传统关系型数据库（例如MySQL、SQL Server）有什么区别？

• 如何理解数据表的主键、数据分区和数据分区键

• 表格存储宽表模型中表、行、列、值和电子表格的类比

相关文档

• 您可以通过命令行工具快速体验宽表模型。具体操作，请参见通过命令行工具使用宽表模型。

• 当要在实际业务中使用表格存储时，请参见宽表模型介绍文档了解产品的使用限制、使用流程等信息，并根据业务特点选择合适的计费模式来节省使用成本。更多信息，请参见计费模式使用推荐。

• 如果要通过控制台进行更多宽表模型的功能操作，请参见数据表操作、基础数据操作、通过控制台使用多元索引、通过控制台使用二级索引、通过控制台使用SQL查询、通过控制台使用通道服务、通过控制台投递数据到OSS、通过表格存储控制台查看监控数据文档进行使用。

• 使用宽表模型可以实现元数据、大数据等多种场景的解决方案，例如搭建海量智能元数据管理系统、亿量级订单管理方案、基于多元索引搭建亿量级店铺搜索系统、表格存储结合Spark流批处理实现一体化存储和计算、表格存储结合实时计算Flink进行大数据分析。更多方案介绍，请参见场景实战-典型场景架构与实现。