La forma più comune di query in Drupal è la query statica. Una query statica viene passata al database così com’è, senza modifiche da parte di Drupal. Solo le query di selezione (SELECT) possono essere statiche.

Le query statiche dovrebbero essere usate solo per operazioni molto semplici. Per query più complesse, dinamiche o modificabili a runtime, è preferibile usare le query dinamiche.

Un modo semplice per eseguire una query statica è il seguente:

Probabilmente siamo arrivati alla parte più interessante del Database API di Drupal: le query dinamiche. Si chiamano così perché Drupal costruisce dinamicamente la stringa della query. Tutte le query di inserimento, aggiornamento, eliminazione o unione possono essere dinamiche. Le query di selezione possono essere sia dinamiche che statiche, ma è consigliato usare sempre le query dinamiche anche per le SELECT.

Le query di selezione in Drupal supportano gli extenders (estensioni). Un extender consente di aggiungere funzionalità extra a una query di selezione durante l’esecuzione. Questa funzionalità può essere un nuovo metodo o una modifica del comportamento di un metodo esistente.

Una caratteristica importante delle query dinamiche di selezione in Drupal è la possibilità per altri moduli di modificare una query “al volo”. Ciò consente ad altri moduli di aggiungere istruzioni personalizzate alla query, influenzando così il suo comportamento o applicando modifiche durante l’esecuzione, ad esempio per definire restrizioni di accesso ai nodi. Esistono tre componenti principali per la modifica dinamica delle query: tagging, meta data e hook_query_alter().

Una query di selezione restituirà sempre un risultato che può contenere da 0 a più record. Esistono diversi modi per elaborare i dati restituiti, e puoi scegliere quello più adatto alle tue esigenze.

Il metodo più comune per elaborare i risultati è utilizzare un ciclo foreach():

Le query di inserimento devono sempre essere costruite utilizzando il costruttore di query. Alcuni database richiedono gestori speciali per i campi LOB (Large Object, come TEXT in MySQL) e BLOB (Binary Large Object), quindi è necessario un livello di astrazione per consentire ai driver di database di implementare tali gestori specifici.

Le query di inserimento iniziano con la funzione db_insert():

Le query di aggiornamento devono sempre essere create utilizzando il costruttore di query. I diversi database hanno gestori specifici per i tipi di dati LOB (Large Object, come TEXT in MySQL) e BLOB (Binary Large Object), quindi è necessario un livello di astrazione per consentire ai driver di implementare i propri gestori specifici.

Le query di aggiornamento devono iniziare con la funzione db_update():

Le query di eliminazione devono essere costruite utilizzando il costruttore di query. Esse iniziano con la funzione db_delete():

Le query di unione (MERGE) sono un tipo speciale di query ibrida. Sebbene la sintassi per queste query sia stata definita nello standard SQL 2003, di fatto non esistono database che supportano completamente tale sintassi. Tuttavia, la maggior parte dei database offre un’implementazione alternativa attraverso una propria sintassi specifica. Il costruttore di query di unione di Drupal astrae il concetto di merge in una struttura a oggetti, così che l’oggetto possa essere compilato in modo diverso a seconda del database utilizzato.

Una condizione di query consente di selezionare solo i record che soddisfano determinati criteri, ad esempio i nodi creati non più di due settimane fa, o i termini che contengono la parola "drupal", e così via. In SQL utilizziamo WHERE e HAVING per impostare le condizioni nei comandi SELECT, UPDATE e DELETE. Anche nelle query dinamiche di Drupal è implementato un meccanismo per lavorare con le condizioni di query. Questo meccanismo funziona allo stesso modo per tutti e tre i tipi di query: selezione, aggiornamento ed eliminazione.