DELETE

COMMENTSInstructions de procédure SQL (PSQL)

`DELETE`

affectation

Suppression des données d’une table.

Disponible en

DSQL, ESQL, PSQL

Syntaxe:

DELETE
  FROM target [[AS] alias]
  [WHERE {<search-conditions> | CURRENT OF cursorname}]
  [PLAN <plan_items>]
  [ORDER BY <sort_items>]
  [ROWS m [TO n]]
  [SKIP LOCKED]
  [RETURNING <returning_list> [INTO <variables>]]

<returning_list> ::= * | <output_column> [, <output_column]

<output_column> ::=
    target.*
  | <return_expression> [COLLATE collation] [[AS] ret_alias]

<return_expression> ::=
    <value_expression>
  | [target.]col_name

<value_expression> ::=
    <literal>
  | <context-variable>
  | <other-single-value-expr>

<variables> ::=
  [:]varname [, [:]varname ...]

Table 1. Paramètres de l’opérateur `DELETE`
Paramètre	Description
target	Nom de la table ou de la vue à partir de laquelle les enregistrements doivent être supprimés.
alias	L’alias d’une table ou d’une vue.
col-name	Le nom de la colonne de la table ou de la vue.
search-conditions	Une condition de recherche limitant le jeu d’enregistrements à supprimer.
cursorname	Le nom du curseur sur lequel est positionné l’enregistrement à supprimer.
plan_items	Proposition de plan.
sort_items	Tri de la proposition
m, n	Expressions entières pour limiter le nombre d’entrées à supprimer.
return_expression	Expression renvoyée dans une clause `RETURNING`.
literal	Litéral.
context-variable	La variable de contexte.
other-single-value-expr	Toute autre expression qui renvoie une seule valeur du type de données Firebird ou `NULL`.
collation	Nom de tri existant (pour les types de caractères uniquement).
ret_alias	Alias pour l’expression retournée dans la clause `RETURNING`.
varname	Nom de la variable PSQL.

L’instruction DELETE supprime les lignes d’une table ou d’une ou plusieurs tables de présentation.

Si un alias est spécifié pour une table, il doit être utilisé pour toutes les colonnes de la table.

`WHERE`

La condition de la clause WHERE limite le jeu d’enregistrements à supprimer. Seuls les enregistrements qui satisfont à la condition de recherche ou seulement l’enregistrement curseur nommé actuel sont supprimés.

La suppression avec WHERE CURRENT OF est appelée positioned delete, car elle supprime l’enregistrement à la position actuelle. La suppression avec `WHERE condition' est appelée searched delete, car Firebird recherche les enregistrements qui satisfont à la condition.

Note	En DSQL pur, l’expression `WHERE CURRENT OF` n’a aucun sens car DSQL n’a pas d’instruction pour créer un curseur.

Example 1. Utilisation de la clause WHERE dans l’instruction DELETE.

DELETE FROM People
WHERE first_name <> 'Boris' AND last_name <> 'Johnson';

DELETE FROM employee e
WHERE NOT EXISTS(
  SELECT *
  FROM employee_project ep
  WHERE e.emp_no = ep.emp_no);

DELETE FROM Cities
WHERE CURRENT OF Cur_Cities; -- uniquement en PSQL