class Update in Drupal driver for SQL Server and SQL Azure 8.2

Hierarchy

• class \Drupal\Core\Database\Query\Query implements PlaceholderInterface
  • class \Drupal\Core\Database\Query\Update implements ConditionInterface uses QueryConditionTrait
    • class \Drupal\Driver\Database\sqlsrv\Update

File

drivers/lib/Drupal/Driver/Database/sqlsrv/Update.php, line 24

Definition of Drupal\Driver\Database\sqlsrv\Update

Namespace

Drupal\Driver\Database\sqlsrv

class Update extends QueryUpdate {

  /**
   * @var Connection
   */
  protected $connection;

  /**
   * {@inheritdoc}
   */
  public function execute() {

    // Retrieve query options.
    $options = $this->queryOptions;

    // Check that the table does exist.
    if (!$this->connection
      ->schema()
      ->tableExists($this->table)) {
      throw new \Drupal\Core\Database\SchemaObjectDoesNotExistException("Table {$this->table} does not exist.");
    }

    // Fetch the list of blobs and sequences used on that table.
    $columnInformation = $this->connection
      ->schema()
      ->getTableIntrospection($this->table);

    // MySQL is a pretty slut that swallows everything thrown at it,
    // like trying to update an identity field...
    if (isset($columnInformation['identity']) && isset($this->fields[$columnInformation['identity']])) {
      unset($this->fields[$columnInformation['identity']]);
    }

    // Because we filter $fields the same way here and in __toString(), the
    // placeholders will all match up properly.
    $stmt = $this->connection
      ->prepareQuery((string) $this);

    // Expressions take priority over literal fields, so we process those first
    // and remove any literal fields that conflict.
    $fields = $this->fields;
    $stmt
      ->BindExpressions($this->expressionFields, $fields);

    // We use this array to store references to the blob handles.
    // This is necessary because the PDO will otherwise messes up with references.
    $blobs = [];
    $stmt
      ->BindValues($fields, $blobs, ':db_update_placeholder_', $columnInformation);

    // Add conditions.
    if (count($this->condition)) {
      $this->condition
        ->compile($this->connection, $this);
      $arguments = $this->condition
        ->arguments();
      $stmt
        ->BindArguments($arguments);
    }
    $options = $this->queryOptions;
    $options['already_prepared'] = true;
    $this->connection
      ->query($stmt, [], $options);
    return $stmt
      ->rowCount();
  }
  public function __toString() {

    // Create a sanitized comment string to prepend to the query.
    $prefix = $this->connection
      ->makeComment($this->comments);

    // Expressions take priority over literal fields, so we process those first
    // and remove any literal fields that conflict.
    $fields = $this->fields;
    $update_fields = [];
    foreach ($this->expressionFields as $field => $data) {
      $update_fields[] = $this->connection
        ->quoteIdentifier($field) . '=' . $data['expression'];
      unset($fields[$field]);
    }
    $max_placeholder = 0;
    foreach ($fields as $field => $value) {
      $update_fields[] = $this->connection
        ->quoteIdentifier($field) . '=:db_update_placeholder_' . $max_placeholder++;
    }
    $query = $prefix . 'UPDATE {' . $this->connection
      ->escapeTable($this->table) . '} SET ' . implode(', ', $update_fields);
    if (count($this->condition)) {
      $this->condition
        ->compile($this->connection, $this);

      // There is an implicit string cast on $this->condition.
      $query .= "\nWHERE " . $this->condition;
    }
    return $query;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Query::$comments	protected	property	An array of comments that can be prepended to a query.
Query::$connectionKey	protected	property	The key of the connection object.
Query::$connectionTarget	protected	property	The target of the connection object.
Query::$nextPlaceholder	protected	property	The placeholder counter.
Query::$queryOptions	protected	property	The query options to pass on to the connection object.
Query::$uniqueIdentifier	protected	property	A unique identifier for this query object.
Query::comment	public	function	Adds a comment to the query.
Query::getComments	public	function	Returns a reference to the comments array for the query.
Query::nextPlaceholder	public	function	Gets the next placeholder value for this query object. Overrides PlaceholderInterface::nextPlaceholder
Query::uniqueIdentifier	public	function	Returns a unique identifier for this object. Overrides PlaceholderInterface::uniqueIdentifier
Query::__clone	public	function	Implements the magic __clone function.	1
Query::__sleep	public	function	Implements the magic __sleep function to disconnect from the database.
Query::__wakeup	public	function	Implements the magic __wakeup function to reconnect to the database.
QueryConditionTrait::$condition	protected	property	The condition object for this query.
QueryConditionTrait::alwaysFalse	public	function
QueryConditionTrait::andConditionGroup	public	function
QueryConditionTrait::arguments	public	function		1
QueryConditionTrait::compile	public	function		1
QueryConditionTrait::compiled	public	function		1
QueryConditionTrait::condition	public	function
QueryConditionTrait::conditionGroupFactory	public	function
QueryConditionTrait::conditions	public	function
QueryConditionTrait::exists	public	function
QueryConditionTrait::isNotNull	public	function
QueryConditionTrait::isNull	public	function
QueryConditionTrait::notExists	public	function
QueryConditionTrait::orConditionGroup	public	function
QueryConditionTrait::where	public	function
Update::$arguments	protected	property	An array of values to update to.
Update::$connection	protected	property	Overrides Query::$connection
Update::$expressionFields	protected	property	Array of fields to update to an expression in case of a duplicate record.
Update::$fields	protected	property	An array of fields that will be updated.
Update::$table	protected	property	The table to update.
Update::execute	public	function	Executes the UPDATE query. Overrides Update::execute
Update::expression	public	function	Specifies fields to be updated as an expression.
Update::fields	public	function	Adds a set of field->value pairs to be updated.
Update::__construct	public	function	Constructs an Update query object. Overrides Query::__construct
Update::__toString	public	function	Implements PHP magic __toString method to convert the query to a string. Overrides Update::__toString