protected function 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

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

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