通过控制台使用SQL查询

更新时间:
复制为 MD 格式

通过表格存储控制台创建映射表、编写和执行 SQL 语句、查看查询结果并导出数据,适用于小规模数据查询和验证场景。

前提条件

  • 如果使用 RAM 用户操作,需具备 "Action": "ots:SQL*" 权限。

  • 已创建数据表。

步骤一:创建映射关系

  1. 登录表格存储控制台。可在页面上方切换地域和资源组。

  2. 概览页面,单击实例名称或实例管理

  3. 单击SQL查询页签,然后单击左侧树的添加图标打开创建映射表对话框。

    说明

    当不存在映射表时,系统会自动弹出创建映射表对话框。也可以在 SQL 编辑器中直接编写 CREATE TABLE 语句创建映射。更多信息,请参见DDL 操作

  4. 在对话框中,根据下表说明配置参数。

    参数

    描述

    表类型

    取值范围如下:

    • 普通表(默认):为数据表创建映射关系。

    • 时序表:为时序表创建映射关系。

    表名

    选择需要创建映射的数据表或时序表。

    映射模式

    仅当表类型普通表时可配置。取值范围如下:

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

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

    高级选项

    仅当映射模式表映射时可配置。打开开关后可设置:

    • 一致性模式最终一致(默认,新数据写入后几秒生效)或强一致性(写入后立刻生效)。

    • 不准确的聚合(默认,牺牲精度提升性能)或

    多元索引表

    仅当映射模式多元索引映射时可配置。选择映射表绑定的多元索引。

    映射表表名

    映射表名称。表映射模式下与数据表同名,不可更改。多元索引映射和时序表模式下需手动填写。

    使用分析存储查询

    仅当表类型时序表时可配置。开启后使用分析存储低成本存储和分析时序数据。

    重要

    如果创建了使用分析存储查询的 SQL 映射表,则在删除分析存储时,需同时删除分析存储 SQL 映射表,否则删除分析存储会失败。

  5. 单击下一步:生成SQL

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

    CREATE TABLE `test_table` (
        `pk1` VARCHAR(1024),
        `pk2` BIGINT(20),
        `col_a` BIGINT(20),
        `col_b` BIGINT(20),
        `col_c` MEDIUMTEXT,
        `col_d` MEDIUMTEXT,
        PRIMARY KEY(`pk1`, `pk2`)
    );
    说明
    • 创建映射表时,Schema 中须包含后续查询所需的列。

    • 请确保映射关系中字段数据类型和数据表中字段数据类型相匹配。数据类型映射详情,请参见数据类型映射

  6. 根据实际需要修改映射表的 Schema 后,选中 SQL 语句并单击执行SQL

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

    说明

    每次只能选中并执行一条 SQL 语句。如果未选中,系统默认执行第一条语句。

步骤二:查询数据

创建映射表后,在SQL查询页签,编写并执行 SELECT 语句查询数据。更多 SQL 语法说明,请参见DQL操作

示例:查询 test_table 表的前 3 行数据。

SELECT * FROM test_table LIMIT 3;

执行结果示例:

+------+-----+-------+-------+--------+--------+
| pk1  | pk2 | col_a | col_b | col_c  | col_d  |
+------+-----+-------+-------+--------+--------+
| row1 |   1 |    10 |   100 | apple  | extra1 |
| row2 |   2 |    20 |   200 | banana | extra2 |
| row3 |   3 |    30 |   300 | apple  | extra3 |
+------+-----+-------+-------+--------+--------+
3 Rows

查询到数据后,可单击数据导出,导出最多 2000 条数据到本地 CSV 文件。

相关文档