通过控制台使用SQL查询 - 表格存储

表格存储支持使用SQL查询功能快速查询数据。使用控制台创建映射关系后，您可以执行SELECT语句快速查询所需数据。

前提条件

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

注意事项

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

步骤一：创建映射关系

登录表格存储控制台。
在页面上方，选择资源组和地域。
在概览页面，单击实例名称或在操作列单击实例管理。

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

说明

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

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

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

参数	描述
表类型	表类型。取值范围如下：普通表（默认）：在为数据表创建映射关系时，选择此项。时序表：在为时序表创建映射关系时，选择此项。
表名	表名称。
映射模式	创建映射关系的模式。只有当表类型选择为普通表时才能配置。取值范围如下：表映射（默认）：为已存在的数据表创建映射关系。多元索引映射：为已存在的多元索引创建映射关系。
高级选项	用于配置映射表的一致性模式和是否使用不准确的聚合。打开高级选项开关，即可进行配置。只有当映射模式选择为表映射时才能进行配置。
一致性模式	执行引擎支持的一致性模式。只有打开了高级选项开关后才能配置。取值范围如下：最终一致（默认）：执行的查询结果满足最终一致。此时新数据写入后会在几秒后影响到查询结果。强一致性：执行的查询结果满足强一致性。此时新数据写入后立刻影响到查询结果。
不准确的聚合	是否允许通过牺牲聚合操作的精准度提升查询性能。只有打开了高级选项开关后才能配置。取值范围如下：是（默认）：允许通过牺牲聚合操作的精度来提升查询性能。否：不允许通过牺牲聚合操作的精度提升查询性能
多元索引表	映射表绑定的多元索引名称。只有当映射模式选择为多元索引映射时才能配置。
映射表表名	映射表名称。如果表类型选择为普通表，当映射模式选择为表映射时，映射表表名与数据表名称相同，不能更改；当映射模式选择为多元索引映射时，需要填写映射表名称。如果表类型选择为时序表，请根据实际填写映射表名称。时序表映射关系创建成功后，系统会自动在映射表名前添加`时序表名称::`前缀。

单击生成SQL。
系统会自动生成创建映射表的SQL语句。SQL示例如下：
```
CREATE TABLE `exampletable` (
    `id` BIGINT(20),
    `colvalue` MEDIUMTEXT,
    `content` MEDIUMTEXT,
    PRIMARY KEY(`id`)
);
```
重要
请确保映射关系中字段数据类型和数据表中字段数据类型相匹配。关于数据类型映射的更多信息，请参见SQL数据类型映射。
根据实际需要修改映射表的Schema后，按住鼠标左键拖动选中一条SQL语句并单击执行SQL(F8)。
执行成功后，在执行结果区域会显示执行结果。
重要
- 创建映射表时设置的Schema中需要包括后续查询数据所需的列。
- 执行SQL语句时，请选中一条所需SQL语句，否则系统默认执行第一条SQL语句。
- 执行SQL语句时，一次只能选中一条SQL语句，否则系统会报错。

步骤二：查询数据

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

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

重要

通过数据导出功能最多只能导出2000条数据。如果需要导出的数据较多，请通过DataX、命令行工具等将表格存储数据下载到本地文件。更多信息，请参见将表格存储数据下载到本地文件。

表格存储：通过控制台使用SQL查询