Trabajar con bases de datos en Drupal 7 - Lección 10 - Solicitudes de eliminación (DELETE)

Las consultas de eliminación deben utilizar el constructor de consultas. Comienzan con la función db_delete():

<?php
$query = db_delete('node', $options);
?>

Esta consulta de eliminación eliminará registros de la tabla node. Ten en cuenta que no es necesario encerrar el nombre de la tabla entre llaves, el constructor de consultas lo maneja automáticamente. Las consultas de eliminación utilizan Fluent API, lo que significa que todos los métodos (excepto execute()) devuelven el propio objeto de consulta (igual que en las consultas de actualización e inserción).

Las consultas de eliminación son muy simples y solo utilizan expresiones WHERE. Hablaremos más a fondo de WHERE en una lección posterior, pero por ahora veamos un ejemplo básico de eliminación:

<?php
$num_deleted = db_delete('node')
  ->condition('nid', 5)
  ->execute();
?>

Esta consulta eliminará todas las filas de la tabla node donde nid = 5.

Esta consulta es equivalente a la siguiente sentencia SQL:

DELETE FROM {node} WHERE nid=5;

El método execute() devuelve la cantidad de registros que fueron eliminados como resultado de la ejecución de la consulta.