使用SDK - Tablestore

注意事項

目前支援使用SQL查詢功能的地區有華東1（杭州）、華東2（上海）、華北2（北京）、華北3（張家口）、華南1（深圳）、德國（法蘭克福）和新加坡。

前提條件

如果要使用RAM使用者進行操作，請確保已建立RAM使用者，並為RAM使用者授予所有SQL操作許可權，即在自訂權限原則中配置"Action": "ots:SQL*"。具體操作，請參見配置RAM使用者權限。
已擷取AccessKey（包括AccessKey ID和AccessKey Secret）。具體操作，請參見擷取AccessKey。
已建立資料表。
已初始化Client。具體操作，請參見初始化。

使用

您可以使用如下語言的SDK實現SQL查詢功能。

參數


參數	說明
query	SQL語句，請根據所需功能進行設定。

樣本

通過create table語句為已存在的表建立映射關係後，您可以通過select語句查詢表中資料。

通過create table語句為已存在的表建立映射關係。

使用create table test_table (pk varchar(1024), long_value bigint, 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, double_value double, string_value mediumtext, bool_value bool, primary key(pk))");

    // 擷取SQL的響應結果。
    SQLQueryResponse response = 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