function db_query

8.x db_query($query, array $args = array(), array $options = array())

Executes an arbitrary query string against the active database.

Use this function for SELECT queries if it is just a simple query string. If the caller or other modules need to change the query, use db_select() instead.

Do not use this function for INSERT, UPDATE, or DELETE queries. Those should be handled via db_insert(), db_update() and db_delete() respectively.


$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

DatabaseStatementInterface A prepared statement object, already executed.

See also


Related topics

95 calls to db_query()
aggregator_category_load in drupal/core/modules/aggregator/aggregator.module
Loads an aggregator category.
aggregator_cron in drupal/core/modules/aggregator/aggregator.module
Implements hook_cron().
Batch::getAllItems in drupal/core/lib/Drupal/Core/Queue/Batch.php
Retrieves all remaining items in the queue.
book_node_load in drupal/core/modules/book/book.module
Implements hook_node_load().
book_node_predelete in drupal/core/modules/book/book.module
Implements hook_node_predelete().

... See full list

2 string references to 'db_query'
drupal_get_filename in drupal/core/includes/
Returns and optionally sets the filename for a system resource.
_drupal_decode_exception in drupal/core/includes/
Decodes an exception and retrieves the correct caller.


drupal/core/includes/, line 210
Core systems for the database layer.


function db_query($query, array $args = array(), array $options = array()) {
  if (empty($options['target'])) {
    $options['target'] = 'default';

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