DESCRIPTION.

Créer un nouvel objet curseur, lié par une objet connexion, avec une base de données.

SYNTAXE.

Cur_Curseur = sqlite3.Cursor ( connexion , attribut = valeur )

Cur_Curseur = ⇨ affectation de l'instance du curseur [ optionnel ]

sqlite3.Cursor ( ) ⇨ création d'une instance de tkinter.Cursor ( ) [ OBLIGATOIRE ]

connexion ⇨ objet connexion [ OBLIGATOIRE ]

attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur [ optionnel ]

GENERALITES. 

La classe sqlite3.Cursor ( ) crée des objets curseurs.

La création d'un objet curseur avec le constructeur de classe sqlite3.Cursor ( ) est facultative. Toutes les méthodes de la classe sqlite3.Cursor ( ) : curseur.execute ( ), curseur.fetchall ( ), ... , peuvent être appelées anonymement,  par des méthodes du module sqlite3 et/ou la classe sqlite3.Connection ( ). Dans ce cas Python crée un objet curseur éphémère, utilise la méthode appelée, directement, de cette objet curseur éphémère, puis ferme cette objet curseur éphémère. Toutefois la création d'un objet curseur avec la méthode CUR_Curseur = BDD_Basse.cursor ( ) est vivement conseillée. 

Ainsi :

BDD_Test = sqlite3.connect ( fichier ) 

BDD_Test.execute ( " SELECT * FROM table " )

BDD_Test.fetchall ( )

BDD_Test.close ( )

BDD_Test = sqlite3.Connection ( fichier )  

CUR_Test = BDD_Test.Cursor ( BDD_Test )

BDD_Test.execute ( " SELECT * FROM table " )

BDD_Test.fetchall ( )

BDD_Test.close ( )

 BDD_Test = sqlite3.connect ( fichier ) 

 CUR_Test = BDD_Test.Cursor ( BDD_Test )

 CUR_Test.execute ( " SELECT * FROM table " )

 CUR_Test.fetchall ( )

 BDD_Test.close ( )

sont équivalent. Même si l'on préférera, pour une meilleur lisibilité et mainteance du script :

BDD_Test = sqlite3.connect ( fichier ) 

CUR_Test = BDD_Test.cursor ( )

CUR_Test.execute ( " SELECT * FROM table " )

CUR_Test.fetchall ( )

BDD_Test.close ( )

Aller à tutoriel du module sqlite3.

Aller à présentation des commandes SQL.

LISTE DES ATTRIBUTS DE LA CLASSE CURSOR. 

arraysize : retourne le nombre d'enregistrements (fiches) qui seront lus par objet.fetchmany ( ).

connection : retourne le nom de l'objet-connexion lié à l'objet-curseur.

description : retourne le nom des colonnes lu par la dernière requête.

lastrowid : retourne l'Id de l'enregistrement (fiche) qui a été modifié en dernier.

row_factory : retourne les valeurs des champs dans un objet-ligne au lieu d'un tuple ( ).

rowcount : retourne le nombre d'enregistrements qui ont été modifiées ou créées depuis le début de la connexion.

LISTE DES METHODES DE LA CLASSE CURSOR. 

close ( ) : ferme la liaison entre un objet connexion et un objet curseur.

execute ( ) : exécute une commande SQL en relation avec la base de données. 

executemany ( ) : exécute une commande SQL autant de fois qu'il y a d'enregistrements à modifier. 

executescript ( ) : exécute plusieurs commandes SQL en relation avec la base de données.

fetchall ( ) : retourne toutes les fiches dans la pile des résultats après une requête SQL.

fetchmany ( ) : retourne le nombre précisé de fiches dans la pile des résultats après une requête SQL.

fetchone ( ) : retourne la fiche suivante dans la pile des résultats après une requête SQL.

Notes : les méthodes curseur.setinputsizes ( ) et curseur.setoutputsize ( ), requis par la DB-API, sont sans effet dans sqlite3.