控制台

前提条件

• 如果要使用RAM用户进行操作，请确保已创建RAM用户，并为RAM用户授予所有SQL操作权限，即在自定义权限策略中配置"Action": "ots:SQL*"。具体操作，请参见通过RAM Policy为RAM用户授权。

• 已创建数据表。

注意事项

目前支持SQL查询功能的地域包括华东1（杭州）、华东2（上海）、华北2（北京）、华北3（张家口）、华北6（乌兰察布）、华南1（深圳）、西南1（成都）、中国香港、日本（东京）、新加坡、马来西亚（吉隆坡）、印度尼西亚（雅加达）、德国（法兰克福）、英国（伦敦）、美国（硅谷）、美国（弗吉尼亚）。

步骤一：创建映射关系

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

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

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

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

   说明

   您也可以直接手动编写创建映射关系的SQL语句。更多信息，请参见创建表的映射关系和创建多元索引的映射关系。

   1. 单击图标。

      说明

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

      

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

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

      

步骤二：查询数据

创建映射表后，在SQL查询页签，执行SELECT语句查询所需数据。更多信息，请参见查询数据。

查询到数据后，您可以单击数据导出，导出最多2000条数据到本地文件（CSV格式）。

常见问题

• 使用SQL查询数据时如何选择查询方式

• SQL查询常见错误排查

• 使用SQL查询数据时报错The sql scanned rows of main table exceeds the quota, main table rows quota is 100000