Toute requête peut avoir une « requête de comptage » correspondante. Une requête de comptage renvoie le nombre de lignes du résultat de la requête initiale. Pour obtenir une requête de comptage à partir d'une requête existante (qui est un objet de requête select implémentant SelectInterface), utilisez la méthode countQuery().

Certaines requêtes SQL peuvent retourner des résultats en double. Dans ces cas, les lignes dupliquées peuvent être filtrées en utilisant le mot-clé « DISTINCT » dans une requête statique. Dans une requête dynamique, utilisez la méthode distinct().

Pour grouper par un champ donné, utilisez la méthode groupBy().

$query->groupBy('uid');

Le code ci-dessus indique à la requête de grouper par le champ uid. Notez que le nom du champ doit ici être un alias, créé par les méthodes addField() ou addExpression(), donc dans la plupart des cas, vous voudrez utiliser la valeur retournée par ces méthodes pour garantir que l’alias correct est utilisé.

Pour obtenir le nombre de lignes groupées par un champ, par exemple uid, vous pouvez faire ce qui suit :

Pour ajouter une clause WHERE à une requête dynamique, utilisez la méthode condition() :

$query->condition('bundle', 'article', '=');

Le code ci-dessus indique à la requête de filtrer les résultats pour le type de contenu « article ». Notez que le nom du champ ici doit être un alias créé par les méthodes addField() ou addExpression().

Paramètres de Condition

La méthode condition() prend trois paramètres :

Une requête Select renverra toujours un objet jeu de résultats contenant zéro ou plusieurs enregistrements. Il existe plusieurs façons d'extraire des données de ce jeu de résultats selon le cas d'utilisation. Par défaut, les enregistrements sont extraits en tant qu'objets, sauf si vous modifiez le mode d'extraction (voir : setFetchMode).

Les requêtes peuvent être extraites en objets basés sur des classes personnalisées. Par exemple, si nous avons une classe nommée ExampleClass, la requête suivante retournera des objets de type ExampleClass.

Les requêtes d'insertion doivent toujours utiliser un objet constructeur de requêtes. Dans certaines bases de données, un traitement spécial des champs LOB (Large OBject, par exemple TEXT dans MySQL) et BLOB (Binary Large OBject) est nécessaire, ce qui demande un niveau d'abstraction pour que les différents pilotes de bases de données puissent implémenter le traitement spécifique requis.

Les requêtes d'insertion sont lancées en utilisant la méthode insert() de la manière suivante :

Les requêtes de fusion représentent un type particulier de requête hybride. Bien que leur syntaxe soit définie dans la spécification SQL 2003, pratiquement aucune base de données ne supporte la syntaxe standard. Cependant, la plupart fournissent une implémentation alternative utilisant une syntaxe spécifique à la base de données. Le constructeur de requêtes de fusion dans Drupal abstrait le concept de requête de fusion en un objet structuré qui peut être compilé avec la syntaxe appropriée pour chaque base de données.

Les requêtes de suppression doivent toujours utiliser un objet constructeur de requêtes. Elles sont exécutées en utilisant la méthode delete() de la manière suivante :

$query = $connection->delete('mytable', $options);

Cela crée un objet de requête de suppression qui supprime des enregistrements de la table mytable. Notez que les accolades ne sont pas nécessaires pour le nom de la table, car le constructeur de requêtes s'en chargera automatiquement.

L'API de la base de données lance des exceptions en cas d'erreur, qui peuvent être interceptées en encapsulant les opérations de base de données dans des blocs try {} catch() {}, comme illustré dans cet exemple :