function Connection::upsert

Prepares and returns an UPSERT query object.

@todo in drupal:11.0.0, make this method abstract since Query\Upsert is an abstract class.

Parameters

string $table: The table to use for the upsert query.

array $options: (optional) An array of options on the query.

Return value

\Drupal\Core\Database\Query\Upsert A new Upsert query object.

See also

\Drupal\Core\Database\Query\Upsert

5 methods override Connection::upsert()
Connection::upsert in core/modules/sqlite/src/Driver/Database/sqlite/Connection.php
Prepares and returns an UPSERT query object.
Connection::upsert in core/modules/mysql/src/Driver/Database/mysql/Connection.php
Prepares and returns an UPSERT query object.
Connection::upsert in core/modules/pgsql/src/Driver/Database/pgsql/Connection.php
Prepares and returns an UPSERT query object.
Connection::upsert in core/tests/fixtures/database_drivers/custom/fake/Connection.php
Prepares and returns an UPSERT query object.
StubConnection::upsert in core/tests/Drupal/Tests/Core/Database/Stub/StubConnection.php
Prepares and returns an UPSERT query object.

File

core/lib/Drupal/Core/Database/Connection.php, line 1166

Class

Connection
Base Database API class.

Namespace

Drupal\Core\Database

Code

public function upsert($table, array $options = []) {
  $class = $this->getDriverClass('Upsert');
  return new $class($this, $table, $options);
}

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