FETCH

Description

FETCH récupère des lignes en utilisant un curseur déjà existant.

Un curseur a une position associée qui est utilisée par FETCH. La position du curseur peut être avant la première ligne du résultat d'une requête, une ligne particulière du résultat ou après la dernière ligne du résultat. Une fois créé, un curseur est positionné sur la ligne la plus récemment récupérée. Si FETCH arrive à la fin des lignes disponibles, alors le curseur est positionné à gauche après la dernière ligne ou avant la première ligne au cas où la récupération se fait en marche arrière. FETCH ALL ou FETCH BACKWARD ALL laissera le curseur positionné après la dernière ligne ou avant la première ligne.

Les formes NEXT, PRIOR, FIRST, LAST, ABSOLUTE, RELATIVE récupèrent une seule ligne après avoir déplacé le curseur de façon appropriée. Si cette ligne n'existe pas, un résultat vide est renvoyé et le curseur est positionné à gauche avant la première ligne ou après la dernière ligne suivant le sens de la progression.

Les formes utilisant FORWARD et BACKWARD récupèrent le numéro de ligne indiqué en se déplaçant en avant ou en arrière, laissant le curseur positionné sur la dernière ligne renvoyée (ou après/avant toutes les lignes si nombre dépasse le nombre de lignes disponibles).

RELATIVE 0, FORWARD 0 et BACKWARD 0 demandent la récupération de la ligne actuelle sans déplacer le curseur, c'est-à-dire une nouvelle récupération de la ligne récemment récupérée. La commande réussira sauf si le curseur est positionné avant la première ligne ou après la dernière ligne ; auquel cas, aucune ligne n'est renvoyée.

Paramètres

Sorties

En cas de succès, une commande FETCH renvoie une balise de commande de la forme

FETCH nombre

Le nombre est le nombre de lignes récupérées (zéro étant possible). Notez que dans psql, la balise de la commande ne sera pas réellement affichée car psql affiche à la place les lignes récupérées.

Notes

Le curseur devrait être déclaré avec l'option SCROLL si vous avez l'intention d'utiliser une variante de FETCH autre que FETCH NEXT ou FETCH FORWARD avec un nombre positif. Pour les requêtes simples, PostgreSQL autorisera les parcours inverses à partir de curseurs non déclarés avec SCROLL, mais ce comportement n'est pas sûr. Si le curseur est déclaré avec NO SCROLL, aucun parcours inverse n'est autorisé.

Les récupérations ABSOLUTE ne sont pas plus rapides que de naviguer vers la ligne désirée avec un déplacement relatif : de toute façon, l'implémentation sous-jacente doit parcourir toutes les lignes intermédiaires. Les récupérations absolues négatives sont même pires : la requête doit être lu à la fin pour trouver la dernière ligne puis faire le parcours inverse. Néanmoins, ce dernier parcours (comme avec FETCH ABSOLUTE 0) est rapide.

Mettre à jour des données via un curseur n'est pas supporté actuellement par PostgreSQL.

DECLARE est utilisé pour définir un curseur. Utilisez MOVE pour modifier la position du curseur sans récupérer les données.

Exemples

L'exemple suivant parcourt une table en utilisant un curseur.

BEGIN WORK;

-- Initialise un curseur :
DECLARE liahona SCROLL CURSOR FOR SELECT * FROM films;

-- Récupère les 5 premières lignes du curseur liahona :
FETCH FORWARD 5 FROM liahona;

 code  |          titre          | did | date_prod  |   genre  |  longueur
-------+-------------------------+-----+------------+----------+-----------
 BL101 | The Third Man           | 101 | 1949-12-23 | Drama    | 01:44
 BL102 | The African Queen       | 101 | 1951-08-11 | Romantic | 01:43
 JL201 | Une Femme est une Femme | 102 | 1961-03-12 | Romantic | 01:25
 P_301 | Vertigo                 | 103 | 1958-11-14 | Action   | 02:08
 P_302 | Becket                  | 103 | 1964-02-03 | Drama    | 02:28

-- Récupère la ligne précédente :
FETCH PRIOR FROM liahona;

 code  |  titre  | did | date_prod  |  genre |  longueur
-------+---------+-----+------------+--------+-----------
 P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08

-- Ferme le curseur et termine la transaction:
CLOSE liahona;
COMMIT WORK;

Compatibilité

Le standard SQL définit FETCH comme étant à utiliser uniquement dans le SQL embarqué. Cette variante de FETCH décrite ici renvoie les données comme s'il s'agissait d'un résultat SELECT plutôt que de le placer dans les variables de l'hôte. En plus de ce point, FETCH est totalement compatible avec le standard SQL.

Les formes FETCH impliquant FORWARD et BACKWARD, ainsi que les formes FETCH nombre et FETCH ALL, dans lesquelles FORWARD est implicite, sont des extensions de PostgreSQL.

Le standard SQL autorise seulement FROM précédant le nom du curseur ; l'option d'utiliser IN est une extension.