[Beego模型] 四、使用SQL語句進行查詢

[Beego模型] 一、ORM 使用方法

[Beego模型] 二、CRUD 操作

[Beego模型] 三、高級查詢

[Beego模型] 四、使用SQL語句進行查詢

[Beego模型] 五、構造查詢

[Beego模型] 六、事務處理

 

• 使用 Raw SQL 查詢，無需使用 ORM 表定義
• 多數據庫，都可直接使用占位符號 ?，自動轉換
• 查詢時的參數，支持使用 Model Struct 和 Slice, Array

ids := []int{1, 2, 3}
p.Raw("SELECT name FROM user WHERE id IN (?, ?, ?)", ids)

創建一個 RawSeter

o := orm.NewOrm()
var r RawSeter
r = o.Raw("UPDATE user SET name = ? WHERE name = ?", "testing", "slene")

• type RawSeter interface {
  • Exec() (sql.Result, error)
  • QueryRow(…interface{}) error
  • QueryRows(…interface{}) (int64, error)
  • SetArgs(…interface{}) RawSeter
  • Values(*[]Params, …string) (int64, error)
  • ValuesList(*[]ParamsList, …string) (int64, error)
  • ValuesFlat(*ParamsList, string) (int64, error)
  • RowsToMap(*Params, string, string) (int64, error)
  • RowsToStruct(interface{}, string, string) (int64, error)
  • Prepare() (RawPreparer, error)
• }

Exec

執行 sql 語句，返回 sql.Result 對象

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

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

QueryRows

QueryRows 支持的對象還有 map 規則是和 QueryRow 一樣的，但都是 slice

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
```

SetArgs

改變 Raw(sql, args…) 中的 args 參數，返回一個新的 RawSeter

用於單條 sql 語句，重復利用，替換參數然后執行。

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 值

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

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 數據

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
total	100
found	200

查詢結果匹配到 map 里

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
total	100
found	200

查詢結果匹配到 struct 里

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，以提高批量執行的速度。

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

 

 

 

摘自：https://beego.me/docs/mvc/model/rawsql.md