このトピックでは、Tablestore SDK for Go を使用して SQL 文を実行し、データをクエリする方法について説明します。
前提条件
クライアントが初期化されていること。 詳細については、「Tablestore クライアントを初期化する」をご参照ください。
データをクエリするテーブルのマッピングテーブルが作成されていること。 詳細については、「マッピングテーブルを作成する」をご参照ください。
パラメーター
パラメーター | 説明 |
query | SQL 文。必要な機能に基づいてこのパラメーターを設定します。 |
例
次の例は、select pk, long_value, double_value, string_value, bool_value from test_table limit 20 文を使用して test_table テーブルのデータをクエリし、最大 20 行のデータを返す方法を示しています。 システムは、クエリ文のリクエストタイプ、戻り値のスキーマ、および返された結果を返します。
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 リクエストの戻り値のスキーマを取得します。
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, falseFAQ
詳細については、「SQL を使用してデータをクエリするときに「メインテーブルのスキャン行数がクォータを超えています。メインテーブルの行クォータは 100000 です」というエラーメッセージが表示される場合の対処方法」をご参照ください。
詳細については、「SQL 文を実行してデータをクエリするときにデータ遅延が発生する場合の対処方法」をご参照ください。
詳細については、「ワイルドカード検索を使用してデータをクエリするときに「[WILDCARD_QUERY] クエリのフィールド値の長さが 32 を超えています」という例外が発生する場合の対処方法」をご参照ください。
関連情報
詳細については、「データのクエリ」をご参照ください。
詳細については、「SQL クエリの一般的なエラーをトラブルシューティングする方法」をご参照ください。