DESCRIPTION.

Retourne un nombre précisé d'enregistrements, dans la pile des résultats trouvés, suite à une requête SQL.  

SYNTAXE.

LST_Donnees = CUR_Curseur.fetchmany ( quantite )

LST_Donnees = ⇨ variable qui recevra la valeur [ optionnel ]

CUR_Curseur ⇨ objet curseur de la base de données [ OBLIGATOIRE ]

.fetchmany ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

quantite ⇨ nombre d’enregistrements attendus [ OBLIGATOIRE ]

REMARQUES. 

quantite doit être un int ( ) positif. Si quantite est omis seule la fiche suivante dans la pile des résultats sera transmise.

La méthode curseur.fetchmany ( ) permet de récupérer des enregistrements, depuis la pile des résultats, dans une list ( ) composée de tuple ( ). Chaque tuple ( ) représente un enregistrement de la table, et les éléments d'un tuple ( ) retournent la valeur du champ correspondant.

S'il reste moins de fiches dans la pile des résultats que quantite, la list ( ) retournée par l'appel de la méthode curseur.fetchmany ( ) ne contiendra que les dernières fiches de la pile, sans ajouter de tuple ( ) vide pour remplacer les fiches manquantes.

Si la pile des résultats est vide, la méthode curseur.fetchmany ( ) retourne une list ( ) vide, [ ],

Pour connaitre les entêtes des colonnes, ou noms des champs, il faut associer à l'attribut curseur.row_factory l'objet-ligne : sqlite3.Row. Les enregistrements retournées par le méthodes curseur.fetchall ( ),  curseur.fetchone ( ) et curseur.fetchmany ( ), ne seront plus des tuple ( ) avec la valeurs du champs des objets-ligne.

Voir la classe sqlite3.Row ( ) pour plus de détails sur les objets lignes.

EXEMPLE. 

import sqlite3

BDD_Connexion = sqlite3.Connection ( "ON - sgbd.db" )

CUR_Curseur = sqlite3.Cursor ( BDD_Connexion )

CUR_Curseur.execute ( " CREATE TABLE IF NOT EXISTS MonCarnet ( Nom text , Taille real , Poids integer ) " )

kclientes = [ ( "Marie" , 158.5 , 58 ) , ( "Emanuelle" , 160 , 52 ) , ( "Parker" , 176.3 , 64 ) , ( "Cécile" , 171 , 62 ) ]

CUR_Curseur.executemany ( " INSERT INTO MonCarnet ( Nom , Taille , Poids ) VALUES ( ? , ? , ? ) " , kclientes )

BDD_Connexion.commit ( )

CUR_Curseur.execute ( " SELECT * FROM MonCarnet " )

print ( CUR_Curseur.fetchmany ( 3 ) )

print ( CUR_Curseur.fetchmany ( 3 ) )

BDD_Connexion.close ( )