SDK

注意事项

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

前提条件

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

• 已获取AccessKey（包括AccessKey ID和AccessKey Secret）。具体操作，请参见创建AccessKey。

• 已创建数据表。

• 已初始化Client。具体操作，请参见初始化OTSClient。

使用流程

您可以通过Java SDK、Go SDK、Python SDK、Node.js SDK、.NET SDK和PHP SDK进行SQL查询操作，此处以Java SDK为例介绍使用SQL查询的操作。

通过create table语句为已存在的表创建映射关系后，您可以通过select语句查询表中数据。具体使用流程如下：

1. 通过create table语句为已存在的表创建映射关系。

   以下示例用于使用create table test_table (pk varchar(1024), long_value bigint(20), double_value double, string_value mediumtext, bool_value bool, primary key(pk))语句创建test_table表的映射关系。

   private static void createTable(SyncClient client) {
       // 创建SQL请求。
       SQLQueryRequest request = new SQLQueryRequest("create table test_table (pk varchar(1024), long_value bigint(20), double_value double, string_value mediumtext, bool_value bool, primary key(pk))");
   
       client.sqlQuery(request);
   }

2. 通过select语句查询表中数据。

   以下示例用于使用select pk, long_value, double_value, string_value, bool_value from test_table limit 20语句查询test_table表中数据且最多返回20行数据。系统会返回查询语句的请求类型、返回值Schema、返回结果等信息。

   private static void queryData(SyncClient client) {
       // 创建SQL请求。
       SQLQueryRequest request = new SQLQueryRequest("select pk, long_value, double_value, string_value, bool_value from test_table limit 20");
   
       // 获取SQL的响应结果。
       SQLQueryResponse response = client.sqlQuery(request);
   
       // 获取SQL的请求类型。
       System.out.println("response type: " + response.getSQLStatementType());
   
       // 获取SQL返回值的Schema。
       SQLTableMeta tableMeta = response.getSQLResultSet().getSQLTableMeta();
       System.out.println("response table meta: " + tableMeta.getSchema());
   
       // 获取SQL的返回结果。
       SQLResultSet resultSet = response.getSQLResultSet();
       System.out.println("response resultset:");
       while (resultSet.hasNext()) {
           SQLRow row = resultSet.next();
           System.out.println(row.getString(0) + ", " + row.getString("pk") + ", " +
                              row.getLong(1) + ", " + row.getLong("long_value") + ", " +
                              row.getDouble(2) + ", " + row.getDouble("double_value") + ", " +
                              row.getString(3) + ", " + row.getString("string_value") + ", " +
                              row.getBoolean(4) + ", " + row.getBoolean("bool_value"));
       }
   }

   返回结果示例如下：

   response type: SQL_SELECT
   response table meta: [pk:STRING, long_value:INTEGER, double_value:DOUBLE, string_value:STRING, bool_value:BOOLEAN]
   response resultset:
   binary_null, binary_null, 1, 1, 1.0, 1.0, a, a, false, false
   bool_null, bool_null, 1, 1, 1.0, 1.0, a, a, null, null
   double_null, double_null, 1, 1, null, null, a, a, true, true
   long_null, long_null, null, null, 1.0, 1.0, a, a, true, true
   string_null, string_null, 1, 1, 1.0, 1.0, null, null, false, false

常见问题

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

• SQL查询常见错误排查

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

相关文档

• 您还可以通过控制台、命令行工具、JDBC或者Go语言驱动使用SQL查询数据。更多信息，请参见通过控制台使用SQL查询、通过命令行工具使用SQL查询、通过JDBC使用SQL查询、通过Go语言驱动使用SQL查询。

• 您还可以将Tablestore实例接入到DataWorks或DMS，然后使用SQL查询与分析Tablestore数据。更多信息，请参见接入到DataWorks和接入到DMS。

• 如果要加速SQL数据查询和计算，您可以通过创建二级索引或者多元索引实现。更多信息，请参见索引选择策略和计算下推。

• 您还可以通过MaxCompute、Spark、Hive或者HadoopMR、函数计算、Flink、PrestoDB等计算引擎实现表中数据的计算与分析。具体操作，请参见计算与分析。

• 如果要以图表等形式可视化展示数据，您可以通过对接Grafana实现。更多信息，请参见对接Grafana。

• SQL查询可应用在表格存储物联网存储IoTstore解决方案中作为不同类型数据的统一查询接口。更多信息，请参见物联网存储简介。

  物联网存储IoTstore是表格存储基于物联网场景中多源异构数据存储、高并发吞吐、海量数据高性价比存储、多维度数据处理与分析等需求推出的一站式物联网解决方案，可为物联网设备元数据、消息数据、时序轨迹等海量数据提供存储、查询、检索、分析、同步等能力。