DESCRIPTION.

Charger une nouvelle extension SQL.

SYNTAXE.

BDD_Base.load_extension ( fichier , nom )

BDD_Base ⇨ objet connexion avec une base de données [ OBLIGATOIRE ]

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

fichier ⇨ identification de la nouvelle extension [ OBLIGATOIRE ]

nom ⇨ nom du point d'entrée de l'exension [ optionnel ]

REMARQUES. 

fichier doit être un str ( ).désignant un nom de fichier, de manière absolue ou relative, contenant l'extension à télécharger.

nom doit être un str ( ) désignant un nom pour le point d'entrée de l'extension. Si nom est absent SQLite proposera son propre point d'entrée. 

Remarque Le module sqlite3 n'est pas construit avec la prise en charge des extensions chargeables par défaut, car certaines plates-formes, notamment macOS, disposent de bibliothèques SQLite qui sont compilées sans cette fonctionnalité. 

Nouveau dans la version 3.2.

La méthode objet.enable_load_extension ( ) doit être appelée avec la valeur True avant d'utiliser la méthode objet.load_extension ( ).

Voir la documentation officiel de SQLite pour plus de détails sur le chargement de nouvelles extensions.

La création d'un objet curseur est facultative. Toutes les méthodes de la classe sqlite3.Cursor ( ) : curseur.execute ( ), curseur.fetchall ( ), ... , peuvent être appelées anonymement. 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. 

Voir la classe sqlite3.Cursor ( ) pour plus d'information sur les objets curseur.

EXEMPLE. 

import sqlite3

LST_Valeurs = [ ( 1 , ) , ( 2 , ) , ( 3 , ) , ( 5 , ) , ( 7 , ) ]

BDD_Connexion = sqlite3.Connection ( ":memory:" )

BDD_Connexion.enable_load_extension ( True )

BDD_Connexion.load_extension ( "votreextention" )

BDD_Connexion.execute ( " CREATE TABLE IF NOT EXISTS premiers ( nombre INTEGER ) " )

BDD_Connexion.executemany ( " INSERT INTO premiers ( nombre ) VALUES ( ? ) " , LST_Valeurs )

BDD_Connexion.commit ( )

BDD_Connexion.close ( )