function db_merge

Same name in other branches
  1. 7.x includes/database/database.inc \db_merge()

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

in drupal:8.0.0 and is removed from 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

https://www.drupal.org/node/2993033

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

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

Related topics

1 call to db_merge()
DatabaseLegacyTest::testDbMerge in core/tests/Drupal/KernelTests/Core/Database/DatabaseLegacyTest.php
Tests deprecation of the db_merge() function.

File

core/includes/database.inc, line 177

Code

function db_merge($table, array $options = []) {
    @trigger_error('db_merge() is deprecated in drupal:8.0.0. It will be removed from 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 https://www.drupal.org/node/2993033', E_USER_DEPRECATED);
    return Database::getConnection(_db_get_target($options, FALSE))->merge($table, $options);
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.