查询数据

前提条件

• 已初始化Client。具体操作，请参见初始化OTSClient。

• 已创建映射关系。具体操作，请参见创建表的映射关系。

参数

示例

以下示例用于使用select pk, long_value, double_value, string_value, bool_value from test_table limit 20语句查询test_table表中数据且最多返回20行数据。系统会返回查询语句的请求类型、返回值Schema、返回结果等信息。

func queryData(client *tablestore.TableStoreClient) {
    // 创建SQL请求。
    request := &tablestore.SQLQueryRequest{Query: "select pk, long_value, double_value, string_value, bool_value from test_table limit 20"}

    // 获取SQL的响应结果。
    response, err := client.SQLQuery(request)
    if err != nil {
        panic(err)
    }

    // 获取SQL的请求类型。
    fmt.Printf("response type: %v\n", response.StmtType.String())

    // 获取SQL返回值的Schema。
    columns := response.ResultSet.Columns()
    fmt.Printf("response table meta: [")
    for i := 0; i < len(columns); i++ {
        fmt.Printf("%v:%v ", columns[i].Name, columns[i].Type.String())
    }

    // 获取SQL的返回结果。
    resultSet := response.ResultSet
    fmt.Println("]\nresponse resultset:")
    for resultSet.HasNext() {
        row := resultSet.Next()
        stringValue, _ := row.GetString(0)
        fmt.Printf("%v, ", stringValue)
        stringValue, _ = row.GetStringByName("pk")
        fmt.Printf("%v, ", stringValue)
        longValue, _ := row.GetFloat64(1)
        fmt.Printf("%v, ", longValue)
        longValue, _ = row.GetFloat64ByName("long_value")
        fmt.Printf("%v, ", longValue)
        floatValue, _ := row.GetFloat64(2)
        fmt.Printf("%v, ", floatValue)
        floatValue, _ = row.GetFloat64ByName("double_value")
        fmt.Printf("%v, ", floatValue)
        stringValue, _ = row.GetString(3)
        fmt.Printf("%v, ", stringValue)
        stringValue, _ = row.GetStringByName("string_value")
        fmt.Printf("%v, ", stringValue)
        boolValue, _ := row.GetBool(4)
        fmt.Printf("%v, ", boolValue)
        boolValue, _ = row.GetBoolByName("bool_value")
        fmt.Printf("%v\n", boolValue)
    }
}

返回结果示例如下：

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, 0, 0, 1, 1, a, a, false, false
bool_null, bool_null, 0, 0, 1, 1, a, a, false, false
double_null, double_null, 0, 0, 1, 1, a, a, false, false
long_null, long_null, 0, 0, 1, 1, a, a, false, false
string_null, string_null, 0, 0, 1, 1, , , 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、函数计算、Flink、PrestoDB等计算引擎实现表中数据的计算与分析。具体操作，请参见计算与分析。

• 当日常业务中有非主键列查询、多列组合查询、模糊查询等多维查询需求以及求最值、统计行数、数据分组等数据分析需求时，您可以将这些属性作为多元索引中的字段并使用多元索引查询与分析数据。 更多信息，请参见多元索引。

  说明

  除了SQl引擎，表格存储还提供了表引擎、二级索引和多元索引用于数据查询，您需要根据实际查询场景选择合适的查询方式。更多信息，请参见索引介绍和索引选择。