ThinkChat2.0新版上线,更智能更精彩,支持会话、画图、阅读、搜索等,送10W Token,即刻开启你的AI之旅 广告
# 插入更新 ### [](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']); ~~~