db_query_temporary

  1. drupal
    1. 5 database.pgsql.inc
    2. 5 database.mysqli.inc
    3. 5 database.mysql.inc
    4. 6 database.mysqli.inc
    5. 6 database.mysql.inc
    6. 6 database.pgsql.inc
    7. 7
    8. 8
Versions
5 – 6 db_query_temporary($query)
7 – 8 db_query_temporary($query, array $args = array(), array $options = array())

Executes a query string and saves the result set to a temporary table.

The execution of the query string happens against the active database.

Parameters

$query The prepared statement query to run. Although it will accept both named and unnamed placeholders, named placeholders are strongly preferred as they are more self-documenting.

$args An array of values to substitute into the query. If the query uses named placeholders, this is an associative array in any order. If the query uses unnamed placeholders (?), this is an indexed array and the order must match the order of placeholders in the query string.

$options An array of options to control how the query operates.

Return value

The name of the temporary table.

See also

DatabaseConnection::defaultOptions()

Related topics

▾ 2 functions call db_query_temporary()

DatabaseTemporaryQueryTestCase::testTemporaryQuery in modules/simpletest/tests/database_test.test
Confirm that temporary tables work and are limited to one request.
database_test_db_query_temporary in modules/simpletest/tests/database_test.module
Run a db_query_temporary and output the table name and its number of rows.

Code

includes/database/database.inc, line 2373

<?php
function db_query_temporary($query, array $args = array(), array $options = array()) {
  if (empty($options['target'])) {
    $options['target'] = 'default';
  }

  return Database::getConnection($options['target'])->queryTemporary($query, $args, $options);
}
?>