ROW_COUNT

Disponible en

PSQL

Syntaxe
ROW_COUNT
type de résultat de retour

BIGINT

La variable contextuelle ROW_COUNT contient le nombre de lignes affectées par la dernière instruction DML. (INSERT, UPDATE, DELETE, SELECT ou FETCH) dans le déclencheur, la procédure stockée ou le bloc exécutable en cours.

Comportement avec SELECT et FETCH :

  • Après avoir exécuté une requête singleton SELECT (une requête qui ne peut retourner plus d'une ligne de données), ROW_COUNT est 1 si une chaîne de données a été récupérée et 0 sinon ;

  • Dans la boucle FOR SELECT, la variable ROW_COUNT est incrémentée à chaque itération (en commençant par 0 comme première valeur) ;

  • Après la sélection (FETCH) du curseur, ROW_COUNT vaut 1 si une chaîne de données a été récupérée et 0 sinon. La sélection de plusieurs enregistrements à partir du même curseur n'incrémente pas ROW_COUNT après 1.

Important

La variable ROW_COUNT ne peut pas être utilisée pour déterminer le nombre de lignes affectées par les instructions EXECUTE STATEMENT ou EXECUTE PROCEDURE. Pour l'instruction MERGE, la variable ROW_COUNT contiendra 0 ou 1, même si plus d'enregistrements ont été affectés.

Warning

N'utilisez pas la variable ROW_COUNT dans les instructions DML. En effet, cette variable remet sa valeur à 0 avant l'exécution de toute instruction DML, et vous risquez donc de ne pas obtenir ce que vous attendez.

...
UPDATE t2 SET
    evt='upd',
    old_id = old.id, old_x = old.x,
    new_id = new.id, new_x = new.x
WHERE new_id = old.id;

INSERT INTO t2log(evt, affected_rows) VALUES('upd', ROW_COUNT);
...

Dans l'exemple ci-dessus, la colonne affected_rows sera écrite avec des valeurs nulles, même si l'instruction UPDATE a été affectée. Pour corriger cette erreur, la valeur de la variable de contexte ROW_COUNT doit être enregistrée dans une variable locale du module PSQL et utilisée dans une instruction DML avec cette variable locale.

...
DECLARE rc INT;
...
UPDATE t2 SET
    evt='upd',
    old_id = old.id, old_x = old.x,
    new_id = new.id, new_x = new.x
WHERE new_id = old.id;

rc = ROW_COUNT;
INSERT INTO t2log(evt, affected_rows) VALUES('upd', rc);
...
Example 1. Utilisation d'une variable ROW_COUNT
...
UPDATE Figures SET Number = 0 WHERE id = :id;
IF (row_count = 0) THEN
  INSERT INTO Figures (id, Number)
  VALUES (:id, 0);
...