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。
SQL查詢可應用在表格存儲物聯網存儲IoTstore解決方案中作為不同類型數據的統一查詢接口。更多信息,請參見物聯網存儲簡介。
物聯網存儲IoTstore是表格存儲基于物聯網場景中多源異構數據存儲、高并發吞吐、海量數據高性價比存儲、多維度數據處理與分析等需求推出的一站式物聯網解決方案,可為物聯網設備元數據、消息數據、時序軌跡等海量數據提供存儲、查詢、檢索、分析、同步等能力。