Das Hauptmittel zur Definition der Verbindung mit der Datenbank ist das Array $databases in der Datei settings.php. Wie der Name schon sagt, erlaubt $databases die Definition mehrerer Datenbankverbindungen. Es unterstützt auch die Definition mehrerer Ziele. Die Verbindung wird nicht geöffnet (das Verbindungsobjekt wird nicht erstellt), bis ein Teil des Codes zum ersten Mal eine Anfrage an die Datenbank ausführt.

Die allgemeinste Form einer Abfrage in Drupal ist die statische Abfrage. Eine statische Abfrage wird wortwörtlich an die Datenbank übergeben. Nur SELECT-Abfragen können statisch sein.

Statische Abfragen sollten nur bei sehr einfachen Anfragen verwendet werden. Für komplexe, dynamisch erstellte oder zur Laufzeit modifizierte Abfragen sollten Sie dynamische Abfragen verwenden.

Ein einfacher Weg, eine statische Abfrage durchzuführen, ist über die Query-Methode:

Wir sind wohl zur interessantesten Komponente der Drupal Database API gelangt: den dynamischen Abfragen. Dynamische Abfragen heißen so, weil Drupal die Abfragezeichenkette dynamisch ergänzt. Alle Einfüge-, Update-, Lösch- oder Merge-Abfragen können dynamisch sein. SELECT-Abfragen können dynamisch oder statisch sein. Dennoch sollten dynamische Abfragen auch für SELECT-Anfragen verwendet werden.

Abfrageauswahl unterstützt Erweiterungen (Extenders). Eine Erweiterung ermöglicht es, zur Laufzeit zusätzliche Funktionalität zu einer Abfrage hinzuzufügen. Diese Funktionalität kann eine zusätzliche Methode sein oder das Verhalten einer existierenden Methode verändern.

Dafür werden in der OOP Design-Patterns verwendet; Erweiterungen implementieren dabei das Decorator-Pattern. Sie fügen dem dynamischen Objekt zusätzliche Aufgaben hinzu, indem sie flexible alternative Subklassen für die Erweiterungsmethode bereitstellen.

Eine wichtige Eigenschaft dynamischer Select-Abfragen ist die Möglichkeit für andere Module, Abfragen zur Laufzeit zu verändern. Dies erlaubt anderen Modulen, eigene Anweisungen in die Abfrage einzufügen, wodurch das Verhalten der Abfrage beeinflusst oder zur Laufzeit Änderungen vorgenommen werden können, beispielsweise um Zugriffsbeschränkungen für Nodes zu setzen. Es gibt drei Komponenten für die Laufzeitänderung von Abfragen: Tagging, Metadaten und hook_query_alter().

Eine Abfrage zur Auswahl gibt immer das Ergebnis der Abfrageverarbeitung zurück, das 0 oder mehr Datensätze enthält. Es gibt mehrere Möglichkeiten, die Ergebnisse der Abfrage zu verarbeiten, die Sie nach Belieben verwenden können.

Am häufigsten werden die Ergebnisse in einer foreach()-Schleife verwendet.

Einfüge-Abfragen sollten immer den Query-Builder verwenden. Manche Datenbanken benötigen spezielle Handler für LOBs (Large OBjects, wie TEXT in MySQL) und BLOB-Felder (Binary Large OBjects), daher ist eine Abstraktionsschicht notwendig, damit individuelle DB-Treiber diese behandeln können.

Einfüge-Abfragen beginnen mit der Funktion db_insert():

Update-Abfragen sollten immer den Query-Builder verwenden. Unterschiedliche Datenbanken haben spezifische Handler für LOBs (Large OBjects, z. B. TEXT in MySQL) und BLOB-Felder (Binary Large OBjects), daher ist eine Abstraktionsschicht für die individuellen Treiber notwendig, um die spezifischen Handler zu implementieren.

Update-Abfragen beginnen mit der Funktion db_update():

Löschabfragen sollten mit dem Query-Builder durchgeführt werden. Sie beginnen mit der Funktion db_delete():

Merge-Abfragen sind spezielle hybride Abfragen. Obwohl der Syntax-Standard dafür in SQL 2003 definiert wurde, unterstützt keine Datenbank diesen Syntax direkt. Allerdings bieten die meisten Datenbanken alternative Implementierungen mit spezifischem Syntax an. Der Merge-Query-Builder in Drupal abstrahiert das Konzept einer Merge-Abfrage in einem Objekt, das je nach Datenbank unterschiedlich kompiliert wird und deren Besonderheiten berücksichtigt.