La forme la plus générale d'une requête dans Drupal est la requête statique. Une requête statique sera transmise à la base de données telle quelle. Seule la requête de sélection (select) peut être statique.

Il ne faut utiliser les requêtes statiques que pour des requêtes très simples. Vous devriez utiliser des requêtes dynamiques si vous devez écrire une requête complexe, créée dynamiquement ou modifiée après exécution.

Une manière simple d’exécuter une requête statique est via la méthode query :

Nous sommes probablement arrivés à la partie la plus intéressante de l'API Database de Drupal : les requêtes dynamiques. Ces requêtes sont dites dynamiques car Drupal génère dynamiquement la chaîne de la requête. Toutes les requêtes d'insertion, mise à jour, suppression ou fusion peuvent être dynamiques. Les requêtes de sélection peuvent être dynamiques ou statiques. Toutefois, il est recommandé d'utiliser des requêtes dynamiques même pour la sélection.

Les requêtes de sélection supportent les extensions (extenders). Une extension permet d’ajouter des fonctionnalités à une requête de sélection lors de son exécution. Cette fonctionnalité peut être une méthode supplémentaire ou modifier le comportement d’une méthode existante.

Pour cela, des patterns de programmation orientée objet sont utilisés ; les extensions implémentent le Decorator Pattern. Elles ajoutent des responsabilités supplémentaires à un objet dynamique en fournissant une sous-classe alternative flexible pour la méthode étendue.

Une caractéristique importante des requêtes dynamiques de sélection est la possibilité pour d’autres modules de modifier ces requêtes à la volée. Cela permet à ces modules d’insérer leurs propres instructions dans la requête, influençant ainsi son comportement ou appliquant des modifications pendant l’exécution, par exemple pour gérer les droits d’accès aux nœuds. Trois composants interviennent dans la modification dynamique des requêtes : les tags, les méta-données et le hook hook_query_alter().

Une requête de sélection retournera toujours un résultat contenant zéro ou plusieurs enregistrements. Il existe plusieurs façons de traiter les données du résultat que vous pouvez utiliser selon vos besoins.

Le plus souvent, les résultats sont utilisés dans une boucle foreach().

Les requêtes d'insertion doivent toujours utiliser le constructeur de requêtes. Certaines bases de données nécessitent des gestionnaires spécifiques pour les champs LOB (Large OBject, comme le texte dans MySQL) et BLOB (Binary Large OBject), d'où l'importance du niveau d'abstraction pour que les pilotes DB implémentent ces gestionnaires.

Les requêtes d'insertion commencent par l'utilisation de la fonction db_insert() :

Les requêtes de mise à jour doivent toujours utiliser le constructeur de requêtes. Les différentes bases de données ont des gestionnaires spécifiques pour les LOB (Large OBject, tels que TEXT dans MySQL) et les champs BLOB (Binary Large OBject), donc un niveau d’abstraction est nécessaire pour que les pilotes individuels implémentent leurs gestionnaires spécifiques.

Les requêtes de mise à jour commencent toujours par la fonction db_update() :

Les requêtes de suppression doivent utiliser le constructeur de requêtes. Elles commencent par la fonction db_delete() :

Les requêtes de fusion sont un type spécial hybride de requêtes. Bien que la syntaxe pour ces requêtes ait été définie dans SQL 2003, en réalité aucune base de données ne supporte cette syntaxe. Cependant, la plupart des bases de données fournissent une implémentation alternative en utilisant une syntaxe spécifique. Le constructeur de requêtes de fusion dans Drupal abstrait le concept de fusion de requête dans une structure objet, de sorte que cet objet peut être compilé différemment pour chaque base de données en tenant compte de ses spécificités.

La condition d’une requête permet de sélectionner uniquement les enregistrements répondant à certaines contraintes, par exemple les nœuds créés depuis moins de deux semaines, les termes contenant le mot "drupal", etc. En SQL, on utilise WHERE et HAVING pour définir des restrictions sur les requêtes SELECT, UPDATE, DELETE. Dans les requêtes dynamiques, un mécanisme similaire existe pour gérer ces conditions, fonctionnant de la même manière pour les trois types de requêtes : sélection, mise à jour, suppression.