Tablestore：查詢資料

前提條件

• 已初始化Client。具體操作，請參見初始化OTSClient。

• 已建立映射關係。具體操作，請參見建立表的映射關係。

注意事項

Table StoreJava SDK從5.13.0版本開始支援SQL查詢功能。使用SQL查詢功能時，請確保擷取了正確的Table StoreJava SDK版本。關於Java SDK歷史迭代版本的更多資訊，請參見Java SDK歷史迭代版本。

參數

樣本

以下樣本用於使用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查詢資料時報錯The sql scanned rows of main table exceeds the quota, main table rows quota is 100000

相關文檔

• 如果要加速SQL資料查詢和計算，您可以通過建立二級索引或者多元索引實現。更多資訊，請參見索引選擇策略和計算下推。

• 如果資料表的屬性列有增加或刪除，您可以通過ALTER TABLE語句同步修改映射表。更多資訊，請參見更新映射表屬性列。

• 如果需要查詢表的描述資訊，您可以通過DESCRIBE語句實現。更多資訊，請參見查詢表的描述資訊。

• 如果不再需要使用表或者多元索引的映射關係，您可以通過DROP MAPPING TABLE語句刪除映射關係。更多資訊，請參見刪除映射關係。

• 如果需要查看錶的索引資訊，您可以通過SHOW INDEX語句實現。更多資訊，請參見查詢索引描述資訊。

• 如果需要列出當前資料庫中的表名稱列表，您可以通過SHOW TABLES語句實現。更多資訊，請參見列出映射表名稱列表。

• 您還可以通過MaxCompute、Spark、Hive或者HadoopMR、Function Compute、Flink、PrestoDB等計算引擎實現表中資料的計算與分析。具體操作，請參見計算與分析。