文档

通过控制台使用SQL查询

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

前提条件

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

  • 已创建数据表。

注意事项

目前支持使用SQL查询功能的地域有华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华南1(深圳)、中国香港、德国(法兰克福)、美国(弗吉尼亚)、印度(孟买)和新加坡。

步骤一:创建映射关系

  1. 登录表格存储控制台

  2. 在页面上方,选择地域,例如华东1(杭州)、华南1(深圳)等。

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

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

    说明

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

    1. 单击fig_createtablevitural图标。

      说明

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

      image.png
    2. 创建映射表对话框,根据下表说明配置参数。

      参数

      描述

      表类型

      表类型。取值范围如下:

      • 普通表(默认):为数据表创建映射关系时,选择此项。

      • 时序表:为时序表创建映射关系时,选择此项。

      表名

      表名称。

      映射模式

      创建映射关系的模式。只有当表类型选择为普通表时才能配置。取值范围如下:

      • 表映射(默认):为已存在的数据表创建映射关系。

      • 多元索引映射:为已存在的多元索引创建映射关系。

      高级选项

      用于配置映射表的一致性模式和是否使用不准确聚合。打开高级选项开关,即可进行配置。只有当映射模式选择为表映射时才能配置。

      一致性模式

      执行引擎支持的一致性模式。只有打开了高级选项开关后才能配置。取值范围如下:

      • 最终一致(默认):执行的查询结果满足最终一致。此时新数据写入后会在几秒后影响到查询结果。

      • 强一致性:执行的查询结果满足强一致性。此时新数据写入后立刻影响到查询结果。

      不准确聚合

      是否允许通过牺牲聚合操作的精准度提升查询性能。只有打开了高级选项开关后才能配置。取值范围如下:

      • (默认):允许通过牺牲聚合操作的精度提升查询性能。

      • :不允许通过牺牲聚合操作的精度提升查询性能

      多元索引表

      映射表绑定的多元索引名称。只有当映射模式选择为多元索引映射时才能配置。

      映射表表名

      映射表名称。

      • 如果表类型选择为普通表,当映射模式选择为表映射时,映射表表名与数据表名称相同,不能更改;当映射模式选择为多元索引映射时,需要填写映射表名称。

      • 如果表类型选择为时序表,请根据实际填写映射表名称。时序表映射关系创建成功后,系统会自动在映射表名前添加时序表名称::前缀。

    3. 单击生成SQL

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

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

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

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

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

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

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

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

      fig_sqlquery

步骤二:查询数据

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

  • 本页导读 (1)
文档反馈