Interface de programmation

Interrogation d'une base de données SQLite

À la suite des opérations ci-dessus, un fichier nommé Librairie.sq3 aura été créé à l’emplacement indiqué dans votre machine. Vous pourriez dès lors quitter Python, et même éventuellement éteindre votre ordinateur : les données sont enregistrées. Maintenant, comment faut-il procéder pour y accéder à nouveau ? C’est très simple : il suffit d’utiliser exactement les mêmes instructions :

L’interrogation de la base s’effectue bien évidemment à l’aide de requêtes SQL, que l’on confie à la méthode execute() du curseur, toujours sous la forme de chaînes de caractères :

Cette requête demande la sélection de tous les enregistrements de la table Client, qui devront être transférés de la base de données au curseur. Pour visualiser les enregistrements situés dans le curseur, plusieurs méthodes peuvent être utilisées. Ces méthodes peuvent paraître différentes à première vue mais en réalité tirent toutes parti du fait que l'objet-curseur produit par Python est un itérateur, c'est-à-dire un dispositif générateur de séquences pouvant être parcouru comme une liste ou un tuple:

• Vous pouvez parcourir directement la séquence qu’il produit, à l’aide d’une boucle for classique. Vous obtenez alors une série de tuples :
  
• Vous pouvez recueillir les enregistrements dans une liste ou un tuble en vue d'un traitement ultérieur, à l'aide des fonctions intégrées list() et tuple():
  
• Vous pouvez également, d’une manière plus classique, faire appel à l'une des méthodes fetchone() ou fetchall() du curseur. La première retournera alors le premier enregistrement de la table sous la forme d'un tuple alors que la second renverra l'ensemble des enregistrements encore présents dans le curseur sous la forme d'une liste de tuples:
  

Dans les méthodes de visualisation présentés ci-dessus, l'accès à la valeur d'un champ qui compose un enregistrement se fait alors par indexation:

Cette manière d'accéder aux valeurs des champs d'un enregistrement présente un défaut majeur: la position de chaque champs d'un enregistrement doit être connue à l'avance. Afin de faciliter cet accès, il serait préférable que chaque objet contenu dans le curseur soit d'un type similaire à un dictionnaire; ceci permettrait en effet l'accès aux valeurs des champs directement à partir de leur nom et non plus à partir de leur position. Ceci est possible grâce à la classe Row du module sqlite3. Un objet de ce type présente un enregistrement sous forme de conteneur associant chaque nom de champ à sa valeur et s'instancie de la manière suivante:

Il est alors possible d'extraire plusieurs enregistrement de la manière suivante:

Tant que le curseur reste ouvert, vous pouvez bien entendu ajouter des enregistrements supplémentaires :

Pour modifier un ou plusieurs enregistrements, vous pouvez faire appel à la clause UPDATE:

Pour supprimer un ou plusieurs enregistrements, vous pouvez faire appel à la clause DELETE:

Finalement, notons que, dans un programme concret, les données à enregistrer se présenteront la plupart du temps dans des variables Python. Vous devrez donc construire la chaîne de caractères contenant la requête SQL, en y incluant les valeurs tirées de ces variables. Il est cependant fortement déconseillé de faire appel dans ce but aux techniques ordinaires de formatage des chaînes, car cela peut ouvrir une faille de sécurité dans vos programmes, en y autorisant les intrusions par la méthode de piratage connue sous le nom de SQL injection. Il faut donc plutôt confier le formatage de vos requêtes au module d’interface lui-même. La bonne technique est illustrée ci-après : la chaîne « patron » utilise le point d’interrogation comme balise de conversion, et le formatage proprement dit est pris en charge par la méthode execute() du curseur :

Dans cet exemple, la chaîne de requête comporte 5 points d’interrogation, qui sont nos balises. Elles seront remplacées par les 5 éléments du tuple ligne à chaque itération de la boucle, le module d’interface avec SQLite se chargeant de traiter chaque variable correctement en fonction de son type.