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/lib/Drupal/Core/Database/Query/Upsert.php

Executes the UPSERT operation.

Upsert::execute in core/modules/pgsql/src/Driver/Database/pgsql/Upsert.php

Executes the UPSERT operation.

File

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

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;
}

---