public function Connection::queryTemporary

Same name in this branch
  1. 9.x drupal/core/lib/Drupal/Core/Database/Connection.php \Drupal\Core\Database\Connection::queryTemporary()
  2. 9.x drupal/core/lib/Drupal/Core/Database/Driver/mysql/Connection.php \Drupal\Core\Database\Driver\mysql\Connection::queryTemporary()
  3. 9.x drupal/core/lib/Drupal/Core/Database/Driver/sqlite/Connection.php \Drupal\Core\Database\Driver\sqlite\Connection::queryTemporary()
  4. 9.x drupal/core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php \Drupal\Core\Database\Driver\pgsql\Connection::queryTemporary()

Runs a SELECT query and stores its results in a temporary table.

Use this as a substitute for ->query() when the results need to stored in a temporary table. Temporary tables exist for the duration of the page request. User-supplied arguments to the query should be passed in as separate parameters so that they can be properly escaped to avoid SQL injection attacks.

Note that if you need to know how many results were returned, you should do a SELECT COUNT(*) on the temporary table afterwards.

Parameters

$query: A string containing a normal SELECT SQL query.

$args: An array of values to substitute into the query at placeholder markers.

$options: An associative array of options to control how the query is run. See the documentation for DatabaseConnection::defaultOptions() for details.

Return value

The name of the temporary table.

Overrides Connection::queryTemporary

File

drupal/core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php, line 169
Definition of Drupal\Core\Database\Driver\pgsql\Connection

Class

Connection

Namespace

Drupal\Core\Database\Driver\pgsql

Code

public function queryTemporary($query, array $args = array(), array $options = array()) {
  $tablename = $this
    ->generateTemporaryTableName();
  $this
    ->query(preg_replace('/^SELECT/i', 'CREATE TEMPORARY TABLE {' . $tablename . '} AS SELECT', $query), $args, $options);
  return $tablename;
}