W3cubDocs

/Drupal 8

function db_merge

db_merge($table, array $options = array())

Returns a new MergeQuery object for the active database.

Parameters

string $table: Name of the table to associate with this query.

array $options: An array of options to control how the query operates.

Return value

\Drupal\Core\Database\Query\Merge A new Merge object for this connection.

Deprecated

as of Drupal 8.0.x, will be removed in Drupal 9.0.0. Instead, get a database connection injected into your service from the container and call merge() on it. For example, $injected_database->merge($table, $options);

See also

\Drupal\Core\Database\Connection::merge()

\Drupal\Core\Database\Connection::defaultOptions()

Related topics

Database abstraction layer
Allow the use of different database servers using the same code base.

File

core/includes/database.inc, line 183
Core systems for the database layer.

Code

function db_merge($table, array $options = array()) {
  if (empty($options['target']) || $options['target'] == 'replica') {
    $options['target'] = 'default';
  }
  return Database::getConnection($options['target'])->merge($table, $options);
}

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/core!includes!database.inc/function/db_merge/8.1.x