function Upsert::preExecute

Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/Database/Query/Upsert.php \Drupal\Core\Database\Query\Upsert::preExecute()
  2. 8.9.x core/lib/Drupal/Core/Database/Query/Upsert.php \Drupal\Core\Database\Query\Upsert::preExecute()
  3. 10 core/lib/Drupal/Core/Database/Query/Upsert.php \Drupal\Core\Database\Query\Upsert::preExecute()

Preprocesses and validates the query.

Return value

bool TRUE if the validation was successful, FALSE otherwise.

Throws

\Drupal\Core\Database\Query\NoUniqueFieldException

\Drupal\Core\Database\Query\FieldsOverlapException

\Drupal\Core\Database\Query\NoFieldsException

2 calls to Upsert::preExecute()
Upsert::execute in core/modules/pgsql/src/Driver/Database/pgsql/Upsert.php
Executes the UPSERT operation.
Upsert::execute in core/lib/Drupal/Core/Database/Query/Upsert.php
Executes the UPSERT operation.

File

core/lib/Drupal/Core/Database/Query/Upsert.php, line 65

Class

Upsert
General class for an abstracted "Upsert" (UPDATE or INSERT) query operation.

Namespace

Drupal\Core\Database\Query

Code

protected function preExecute() {
    // Confirm that the user set the unique/primary key of the table.
    if (!$this->key) {
        throw new NoUniqueFieldException('There is no unique field specified.');
    }
    // Confirm that the user did not try to specify an identical
    // field and default field.
    if (array_intersect($this->insertFields, $this->defaultFields)) {
        throw new FieldsOverlapException('You may not specify the same field to have a value and a schema-default value.');
    }
    // Don't execute query without fields.
    if (count($this->insertFields) + count($this->defaultFields) == 0) {
        throw new NoFieldsException('There are no fields available to insert with.');
    }
    // If no values have been added, silently ignore this query. This can happen
    // if values are added conditionally, so we don't want to throw an
    // exception.
    return isset($this->insertValues[0]) || $this->insertFields;
}

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