Tablestore：通過SDK使用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語句查詢表中資料。具體使用流程如下：

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、Function Compute、Flink、PrestoDB等計算引擎實現表中資料的計算與分析。具體操作，請參見計算與分析。

• 如果要以圖表等形式可視化展示資料，您可以通過對接Grafana實現。更多資訊，請參見對接Grafana。