# 插入更新
### [](https://octobercms.com/docs/database/query#inserts)插入物
查询构建器还提供了`insert`一种将记录插入数据库表中的方法。该`insert`方法接受要插入的列名称和值的数组:
~~~
Db::table('users')->insert(
['email' => 'john@example.com', 'votes' => 0]
);
~~~
您甚至可以`insert`通过传递数组数组来一次调用将多个记录插入表中。每个数组代表要插入表中的一行:
~~~
Db::table('users')->insert([
['email' => 'taylor@example.com', 'votes' => 0],
['email' => 'dayle@example.com', 'votes' => 0]
]);
~~~
#### 自动递增ID
如果表具有自动递增的ID,请使用该`insertGetId`方法插入记录,然后检索ID:
~~~
$id = Db::table('users')->insertGetId(
['email' => 'john@example.com', 'votes' => 0]
);
~~~
> **注意:**使用PostgreSQL数据库驱动程序时,insertGetId方法要求将自动递增列命名为`id`。如果您想从其他“序列”中检索ID,则可以将序列名称作为第二个参数传递给`insertGetId`方法。
### [](https://octobercms.com/docs/database/query#updates)更新
除了将记录插入数据库之外,查询构建器还可以使用该`update`方法更新现有记录。与`update`方法一样,该`insert`方法接受包含要更新的列的列和值对的数组。您可以`update`使用以下`where`子句约束查询:
~~~
Db::table('users')
->where('id', 1)
->update(['votes' => 1]);
~~~
#### 更新或插入(每行一个查询)
有时,您可能希望更新数据库中的现有记录,或者如果不存在匹配的记录,则创建它。在这种情况下,`updateOrInsert`可以使用该方法。该`updateOrInsert`方法接受两个参数:用于查找记录的条件数组,以及包含要更新的列的列和值对的数组。
该`updateOrInsert`方法将首先尝试使用第一个参数的列和值对查找匹配的数据库记录。如果记录存在,它将使用第二个参数中的值进行更新。如果找不到该记录,则将插入具有两个参数的合并属性的新记录:
~~~
Db::table('users')
->updateOrInsert(
['email' => 'john@example.com', 'name' => 'John'],
['votes' => '2']
);
~~~
#### 更新或插入/`upsert()`(批处理查询以在一个数据库调用中处理多行)
该`upsert`方法将插入不存在的行,并使用新值更新已存在的行。该方法的第一个参数由要插入或更新的值组成,而第二个参数列出了唯一标识关联表中的记录的列。该方法的第三个也是最后一个参数是一个列数组,如果数据库中已经存在匹配的记录,则应更新该列:
~~~
DB::table('flights')->upsert([
['departure' => 'Oakland', 'destination' => 'San Diego', 'price' => 99],
['departure' => 'Chicago', 'destination' => 'New York', 'price' => 150]
], ['departure', 'destination'], ['price']);
~~~
> **注意:**除SQL Server以外,所有数据库均要求该`upsert`方法第二个参数中的列具有“主”或“唯一”索引。
#### 更新JSON列
更新JSON列时,应使用`->`语法访问JSON对象中的相应键。MySQL 5.7+和PostgreSQL 9.5+支持此操作:
~~~
$affected = Db::table('users')
->where('id', 1)
->update(['options->enabled' => true]);
~~~
#### 增/减
查询构建器还提供了方便的方法来增加或减少给定列的值。这只是一条捷径,与手动编写该`update`语句相比,它提供了更具表达力和简洁的界面。
这两种方法都至少接受一个参数:要修改的列。可以选择传递第二个参数来控制对列进行增减的数量。
~~~
Db::table('users')->increment('votes');
Db::table('users')->increment('votes', 5);
Db::table('users')->decrement('votes');
Db::table('users')->decrement('votes', 5);
~~~
您还可以指定其他列以在操作期间进行更新:
~~~
Db::table('users')->increment('votes', 1, ['name' => 'John']);
~~~
- 基本说明
- 基本操作
- October cms 安装
- 后台控制器路径
- 图标
- 获取安装网上的插件/主题
- 插件构造器使用
- 定时任务
- October后台控制器
- vscode编辑器
- ajax操作
- 使用
- ajax更新组件
- ajax属性API
- JavaScript API
- ajax综合使用
- 主题
- 多语言主题
- 安装市场主题
- 主题程序处理
- 主题
- 页面
- 部件
- 布局
- 内容
- 组件
- 媒体
- 主题表单操作
- 表单使用
- 表单后端程序处理
- 插件
- 自定义插件
- 插件说明
- 插件导航条
- 插件数据库设置
- 插件的设置管理
- 插件的配置文件config
- 组件
- app服务
- app容器
- 扩展行为
- 缓存
- Collection类
- Lazy Collections
- Collection方法
- 助手函数
- 数组助手函数
- 路径助手函数
- 玄乐助手函数
- 其他助手函数
- 错误与记录
- 事件处理
- HTML页面
- 文件与目录操作
- 散列和加密
- 邮件
- 邮件内容
- 邮件发送
- 分页
- 模板解析器
- 动态解析器语法
- 队列消息
- 请求与输入
- 响应
- 视图
- 路由器
- 配置
- 验证操作
- 处理错误消息
- 错误消息与视图
- 可用的验证规则
- 有条件的验证规则
- 验证数组
- 错误消息
- 自定义验证规则
- 模型操作
- 定义模型与其属性
- 检索模型
- 插入与更新
- 删除模型
- 查询范围
- 事件操作
- 关联操作
- 定义关系
- 关系类型
- 多肽关系
- 关系查询
- 渴望加载
- 插入模型
- 数据库操作
- 基本用法
- 数据表结构
- 查询连贯操作
- 结果检索
- select子句
- 插入更新
- where子句
- 排序,分组,限制和偏移
- 文件附件
- Collection操作
- 属性操作
- 系列化json
- 数据库属性
- 数据库行为
- 控制器
- 后台控制器定义
- 后台页面
- 后台组件
- 后台表单
- 表单组件
- 表单视图
- 表单行为
- 后台列表
- 列表行为
- 列表过滤器
- 可用列类型
- 关系行为
- 关系行为类型
- 扩展关系行为
- 列表排序操作
- 导入导出操作
- 用于与权限
- corlate模板修改
- 修改顶部导航
- laravel问题
- 控制器不存在
- 控制器
- 路由组
- laravel笔记
- laravel 安装
- 伪静态配置
- 依赖注入 & 控制器
- 中间件
- 路由文件
- 视图