# 使用SQL語句進行查詢 * 使用 Raw SQL 查詢，無需使用 ORM 表定義 * 多數據庫，都可直接使用占位符號 `?`，自動轉換 * 查詢時的參數，支持使用 Model Struct 和 Slice, Array ```go ids := []int{1, 2, 3} p.Raw("SELECT name FROM user WHERE id IN (?, ?, ?)", ids) ``` 創建一個 **RawSeter** ```go o := orm.NewOrm() var r RawSeter r = o.Raw("UPDATE user SET name = ? WHERE name = ?", "testing", "slene") ``` * type RawSeter interface { * [Exec() (sql.Result, error)](#exec) * [QueryRow(...interface{}) error](#queryrow) * [QueryRows(...interface{}) (int64, error)](#queryrows) * [SetArgs(...interface{}) RawSeter](#setargs) * [Values(*[]Params, ...string) (int64, error)](#values) * [ValuesList(*[]ParamsList, ...string) (int64, error)](#valueslist) * [ValuesFlat(*ParamsList, string) (int64, error)](#valuesflat) * [RowsToMap(*Params, string, string) (int64, error)](#rowstomap) * [RowsToStruct(interface{}, string, string) (int64, error)](#rowstostruct) * [Prepare() (RawPreparer, error)](#prepare) * } #### Exec 執行 sql 語句，返回 [sql.Result](http://gowalker.org/database/sql#Result) 對象 ```go res, err := o.Raw("UPDATE user SET name = ?", "your").Exec() if err == nil { num, _ := res.RowsAffected() fmt.Println("mysql row affected nums: ", num) } ``` #### QueryRow QueryRow 和 QueryRows 提供高級 sql mapper 功能 支持 struct ```go type User struct { Id int UserName string } var user User err := o.Raw("SELECT id, user_name FROM user WHERE id = ?", 1).QueryRow(&user) ``` > from beego 1.1.0 取消了多個對象支持 [ISSUE 384](https://github.com/astaxie/beego/issues/384) #### QueryRows QueryRows 支持的對象還有 map 規則是和 QueryRow 一樣的，但都是 slice ```go type User struct { Id int UserName string } var users []User num, err := o.Raw("SELECT id, user_name FROM user WHERE id = ?", 1).QueryRows(&users) if err == nil { fmt.Println("user nums: ", num) } ``` > from beego 1.1.0 取消了多個對象支持 [ISSUE 384](https://github.com/astaxie/beego/issues/384) #### SetArgs 改變 Raw(sql, args...) 中的 args 參數，返回一個新的 RawSeter 用于單條 sql 語句，重復利用，替換參數然后執行。 ```go res, err := r.SetArgs("arg1", "arg2").Exec() res, err := r.SetArgs("arg1", "arg2").Exec() ... ``` #### Values / ValuesList / ValuesFlat Raw SQL 查詢獲得的結果集 Value 為 `string` 類型，NULL 字段的值為空 `` > from beego 1.1.0 > Values, ValuesList, ValuesFlat 的參數，可以指定返回哪些 Columns 的數據 > 通常情況下，是無需指定的，因為 sql 語句中你可以自行設置 SELECT 的字段 #### Values 返回結果集的 key => value 值 ```go var maps []orm.Params num, err := o.Raw("SELECT user_name FROM user WHERE status = ?", 1).Values(&maps) if err == nil && num > 0 { fmt.Println(maps[0]["user_name"]) // slene } ``` #### ValuesList 返回結果集 slice ```go var lists []orm.ParamsList num, err := o.Raw("SELECT user_name FROM user WHERE status = ?", 1).ValuesList(&lists) if err == nil && num > 0 { fmt.Println(lists[0][0]) // slene } ``` #### ValuesFlat 返回單一字段的平鋪 slice 數據 ```go var list orm.ParamsList num, err := o.Raw("SELECT id FROM user WHERE id < ?", 10).ValuesFlat(&list) if err == nil && num > 0 { fmt.Println(list) // []{"1","2","3",...} } ``` #### RowsToMap SQL 查詢結果是這樣 | name | value | | /cssjs/widgets.js | /cssjs/widgets.js | | total | 100 | | found | 200 | 查詢結果匹配到 map 里 ```go res := make(orm.Params) nums, err := o.Raw("SELECT name, value FROM options_table").RowsToMap(&res, "name", "value") // res is a map[string]interface{}{ // "total": 100, // "found": 200, // } ``` #### RowsToStruct SQL 查詢結果是這樣 | name | value | | /cssjs/widgets.js | /cssjs/widgets.js | | total | 100 | | found | 200 | 查詢結果匹配到 struct 里 ```go type Options struct { Total int Found int } res := new(Options) nums, err := o.Raw("SELECT name, value FROM options_table").RowsToStruct(res, "name", "value") fmt.Println(res.Total) // 100 fmt.Println(res.Found) // 200 ``` > 匹配支持的名稱轉換為 snake -> camel, eg: SELECT user_name ... 需要你的 struct 中定義有 UserName #### Prepare 用于一次 prepare 多次 exec，以提高批量執行的速度。 ```go p, err := o.Raw("UPDATE user SET name = ? WHERE name = ?").Prepare() res, err := p.Exec("testing", "slene") res, err = p.Exec("testing", "astaxie") ... ... p.Close() // 別忘記關閉 statement ```