前提條件

• 已初始化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引擎，表格存儲還提供了表引擎、二級索引和多元索引用于數據查詢，您需要根據實際查詢場景選擇合適的查詢方式。更多信息，請參見索引介紹和索引選擇。