SQL查询为表格存储的多数据引擎提供统一的访问接口,兼容MySQL的查询语法。使用SQL查询数据前,您需要创建表的映射关系。
本文以使用SQL查询数据表中数据为例介绍。关于使用SQL查询时序数据的更多信息,请参见使用SQL查询时序数据。
注意事项
目前支持使用SQL查询功能的地域有华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华北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语句查询表中数据。具体使用流程如下:
通过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); }
通过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
常见问题
相关文档
您还可以通过控制台、命令行工具、JDBC或者Go语言驱动使用SQL查询数据。更多信息,请参见通过控制台使用SQL查询、通过命令行工具使用SQL查询、通过JDBC使用SQL查询、通过Go语言驱动使用SQL查询数据。
您还可以将Tablestore实例接入到DataWorks或DMS,然后使用SQL查询与分析Tablestore数据。更多信息,请参见接入到DataWorks和接入到DMS。
您还可以通过MaxCompute、Spark、Hive或者HadoopMR、函数计算、Flink、PrestoDB等计算引擎实现表中数据的计算与分析。具体操作,请参见计算与分析。
如果要以图表等形式可视化展示数据,您可以通过对接Grafana实现。更多信息,请参见对接Grafana。