`Db`支持原生`SQL`查询操作,主要包括下面两个方法:
>[danger] 原生查询仅支持Db类操作,不支持在模型中调用原生查询方法(包括`query`和`execute`方法)。
## `query`方法
`query`方法用于执行`SQL`查询操作,和`select`方法一样返回查询结果数据集(数组)。
使用示例:
~~~
Db::query('select * from think_user where status=1');
~~~
> 如果你当前采用了分布式数据库,并且设置了读写分离的话,`query`方法默认是在读服务器执行,而不管你的SQL语句是什么。
如果希望从主库读取,可以使用
~~~
Db::query('select * from think_user where status=1', [], true);
~~~
## `execute`方法
`execute`用于更新和写入数据的sql操作,如果数据非法或者查询错误则返回`false `,否则返回影响的记录数。
使用示例:
~~~
Db::execute("update think_user set name='thinkphp' where status=1");
~~~
> 如果你当前采用了分布式数据库,并且设置了读写分离的话,`execute`方法始终是在写服务器执行,而不管你的SQL语句是什么。
## 参数绑定
支持在原生查询的时候使用参数绑定,包括问号占位符或者命名占位符,例如:
~~~php
Db::query("select * from think_user where id=? AND status=?", [8, 1]);
// 命名绑定
Db::execute("update think_user set name=:name where status=:status", ['name' => 'thinkphp', 'status' => 1]);
~~~
>[danger] 注意不支持对表名使用参数绑定
- 简介
- 数据库配置
- 分布式数据库
- 查询构造器
- 查询数据
- 新增数据
- 更新数据
- 删除数据
- 链式操作
- Where
- Table
- Alias
- Field
- Strict
- Limit
- Page
- Order
- Group
- Having
- Join
- Union
- Distinct
- Lock
- Cache
- Comment
- FetchSql
- Force
- Partition
- Replace
- FailException
- Extra
- Duplicate
- Sequence
- Procedure
- View
- 聚合查询
- 分页查询
- 时间查询
- 高级查询
- 子查询
- 原生查询
- 事务操作
- 存储过程
- 查询事件
- JSON字段
- 模型
- 定义
- 新增
- 更新
- 删除
- 查询
- 查询范围
- 只读字段
- JSON字段
- 自动时间写入
- 获取器
- 修改器
- 搜索器
- 类型转换
- 模型输出
- 模型事件
- 虚拟模型
- 关联
- 一对一关联
- 一对多关联
- 远程一对多
- 远程一对一
- 多对多关联
- 多态一对多
- 多态一对一
- 关联预载入
- 关联统计
- 关联输出
- SQL监听
- 缓存机制
- 字段缓存
- 查询缓存
- 扩展
- 自定义查询类
- 自定义数据库驱动