Consultas de eliminación (delete)

Las consultas de eliminación siempre deben usar un objeto constructor de consultas. Se ejecutan usando el método delete() de la siguiente manera:

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

Esto crea un objeto de consulta de eliminación que elimina registros de la tabla mytable. Tenga en cuenta que no se requieren llaves para el nombre de la tabla, ya que el constructor de consultas se encargará de eso automáticamente.

El objeto de consulta de eliminación utiliza una API fluida. Es decir, todos los métodos (excepto execute()) devuelven el mismo objeto de consulta, permitiendo encadenar llamadas a métodos. En muchos casos, esto significa que no es necesario guardar el objeto de consulta en una variable.

Las consultas de eliminación son conceptualmente muy simples y consisten únicamente en una cláusula WHERE. La estructura completa de la cláusula WHERE se describe en detalle en la sección "Condiciones WHERE" y aquí solo se tocará superficialmente.

Una consulta de eliminación completa tendrá la siguiente forma:

$num_deleted = $connection->delete('mytable')
  ->condition('myfield', 5)
  ->execute();

La consulta anterior eliminará todas las filas de la tabla {mytable} donde la columna myfield sea igual a 5. Esto es equivalente a la siguiente consulta SQL:

DELETE FROM {mytable} WHERE myfield=5;

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