使用sqlQuery接口,您可以通过SQL访问表格存储。

注意事项

目前支持使用SQL查询功能的地域有华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华南1(深圳)和新加坡。

前提条件

  • 如果要使用RAM用户进行操作,请确保已创建RAM用户,并为RAM用户授予所有SQL操作权限,即在自定义权限策略中配置"Action": "ots:SQL*"。具体操作,请参见配置RAM用户权限
  • 已获取AccessKey(包括AccessKey ID和AccessKey Secret)。具体操作,请参见获取AccessKey
  • 已创建数据表。
  • 已初始化Client。具体操作,请参见初始化

使用

Java SDK

参数

参数 说明
query SQL语句,请根据所需功能进行设置。

示例

通过create table语句为已存在的表创建映射关系后,您可以通过select语句查询表中数据。

  1. 通过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);
    }
  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