117 lines
2.5 KiB
Markdown
117 lines
2.5 KiB
Markdown
## 使用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 := NewOrm()
|
||
var r RawSeter
|
||
r = o.Raw("UPDATE user SET name = ? WHERE name = ?", "testing", "slene")
|
||
```
|
||
|
||
* type RawSeter interface {
|
||
* [Exec() (int64, error)](#exec)
|
||
* [QueryRow(...interface{}) error](#queryrow)
|
||
* [QueryRows(...interface{}) (int64, error)](#queryrows)
|
||
* [SetArgs(...interface{}) RawSeter](#setargs)
|
||
* [Values(*[]Params) (int64, error)](#values)
|
||
* [ValuesList(*[]ParamsList) (int64, error)](#valueslist)
|
||
* [ValuesFlat(*ParamsList) (int64, error)](#valuesflat)
|
||
* [Prepare() (RawPreparer, error)](#prepare)
|
||
* }
|
||
|
||
#### Exec
|
||
|
||
执行sql语句
|
||
|
||
```go
|
||
num, err := r.Exec()
|
||
```
|
||
|
||
#### QueryRow
|
||
|
||
TODO
|
||
|
||
#### QueryRows
|
||
|
||
TODO
|
||
|
||
#### SetArgs
|
||
|
||
改变 Raw(sql, args...) 中的 args 参数，返回一个新的 RawSeter
|
||
|
||
用于单条 sql 语句，重复利用，替换参数然后执行。
|
||
|
||
```go
|
||
num, err := r.SetArgs("arg1", "arg2").Exec()
|
||
num, err := r.SetArgs("arg1", "arg2").Exec()
|
||
...
|
||
```
|
||
#### Values / ValuesList / ValuesFlat
|
||
|
||
Raw SQL 查询获得的结果集 Value 为 `string` 类型，NULL 字段的值为空 ``
|
||
|
||
#### 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).ValuesList(&list)
|
||
if err == nil && num > 0 {
|
||
fmt.Println(list) // []{"1","2","3",...}
|
||
}
|
||
```
|
||
|
||
#### Prepare
|
||
|
||
用于一次 prepare 多次 exec，以提高批量执行的速度。
|
||
|
||
```go
|
||
p, err := o.Raw("UPDATE user SET name = ? WHERE name = ?").Prepare()
|
||
num, err := p.Exec("testing", "slene")
|
||
num, err = p.Exec("testing", "astaxie")
|
||
...
|
||
...
|
||
p.Close() // 别忘记关闭 statement
|
||
```
|
||
|
||
## FAQ
|
||
|
||
1. 我的 app 需要支持多类型数据库，如何在使用 Raw SQL 的时候判断当前使用的数据库类型。
|
||
|
||
使用 Ormer 的 [Driver方法](Orm.md#driver) 可以进行判断
|