DRUPAL8模块开发 - DRUPAL8数据库API - 合并查询

翻译者:长风Drupal开发团队(成都长风云信息技术有限公司)

Drupal开发中,合并查询是一种特殊类型的混合查询。虽然在SQL 2003规范中为它们定义了语法,但实际上没有数据库支持标准语法。然而,大多数使用特定于数据库的语法提供一些替代的实现。Drupal中的合并查询生成器将合并查询的概念抽象为结构化对象,该结构对象可以被编译成每个数据库的适当语法。这些有时被称为“UPSERT”查询,UPDATE 和INSERT的组合。

一般意义上,合并查询是插入查询和更新查询的组合。如果满足给定条件,如排给定主键已经存在,则更新运行查询。如果没有,插入查询运行。在大多数情况下,它相当于:

if ($connection->query("SELECT COUNT(*) FROM {example} WHERE id = :id", [':id' => $id])->fetchField()) {

// Run an update using WHERE id = $id}else {

// Run an insert, inserting $id for id }

实际的实现从数据库到数据库变化很大。请注意,虽然合并查询在概念上是原子操作,但它们可能是或可能不是真正的原子依赖于特定数据库的实现。MySQL实现是一个单原子查询,但退化情况(以上)不是。

下面列出了用于合并查询的最常见的习惯用法。

$connection->merge('example')

->key(['name' => $name])

->fields([

'field1' => $value1,

'field2' => $value2,

])

->execute();

在上面的例子中,我们指示查询在“example”表操作。然后我们指定一个关键字段,“name”,使用$name值。然后,我们指定要设置的值数组。

如果表中已经存在的字段“name”有$name,然后field1和field2将被更新。如果这一行不存在,则将创建在这条记录,字段有vlaue $value1,和value $value2。因此,在查询结束,最终的结果是取决于name这个字段的值$name是否存在。

设置条件

Drupal开发的一些实际应用中,您可能希望设置不同的值,取决于是否备案,由key()字段标识,已经存在。有两种方法可以做到这一点。

$connection->merge('example')

->insertFields([

'field1' => $value1,

'field2' => $value2,

])

->updateFields([

'field1' => $alternate1,

])

->key(['name' => $name])

->execute();

上面的示例将与第一个实例相同,除了如果记录已经存在并且我们正在更新它,字段1将被设置为$alternate1 而不是$Value1,字段2不会受到影响。的updateFields() 方法接受的价值观或两并行数值数组一个数组,必须以相同的顺序一个字段对应一个值。

$connection->merge('example')

->key(['name' => $name])

->fields([

'field1' => $value1,

'field2' => $value2,

])

->expression('field1', 'field1 + :inc', [':inc' => 1])

->execute();

在这个drupal案例中,如果记录已经存在,那么field1将被设置为其当前值加1。这使得它对于“计数器查询”非常有用,在每次发生某个事件时,您希望在数据库中增加一些计数器。无论记录是否存在,Field2仍将被设置为相同的值。

注意,expression()可以多次调用,每一次场,应该如果已经存在的记录集的表达。第一个参数是场,二是SQL片段指示字段应被设置的表达,和可选的三参数占位符的值插入到表达阵列。

也没有要求,用于expression()领域已经出现在fields()。