DESCRIPTION.

Indique une fonction à exécuter après d'un certain nombre de commandes SQL.

SYNTAXE.

BDD_Base.set_progress_handler ( fonction , quantite )

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

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

fonction ⇨ méthode à exécuter [ OBLIGATOIRE ]

quantite ⇨ nombre d'instructions réalisées [ OBLIGATOIRE ]

REMARQUES. 

fonction doit être le nom d'une méthode personnalisée existante, créée et définie au préalable avec l'instruction def. La paire de parenthèse, après le nom de la fonction, de doivent pas être présentes.

quantite doit être un int ( ) quelconque mais valide.

fonction sera appelée chaque que fois que quantite d'instructions de commandes ont été exécuté. Cela peut être utile si une commande doit produire une grande quantité d'instructions dans de volumineuses tables,  par exemple,  pour informer de l'état d'avancement des ces commandes et faire patienter l'opérateur.

Si fonction vaut None, plus aucune fonction ne sera appelée.

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

def FNC_Maj ( ) :

LST_Actions.append ( 1 )

print ( "Action en cour : " , len ( LST_Actions ) * 25 , "réalisées. Merci de patienter ... " )

LST_Valeurs = [ ( kvaleur , kvaleur ** 2 , kvaleur ** .5 ) for kvaleur in range ( 100 ) ]

LST_Actions = [ ]

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

BDD_Connexion.set_progress_handler ( FNC_Maj , 25 )

BDD_Connexion.execute ( " CREATE TABLE IF NOT EXISTS numeros ( nombre INTEGER , carre INTEGER , racine INTEGER ) " )

BDD_Connexion.executemany ( " INSERT INTO numeros ( nombre , carre , racine ) VALUES ( ? , ? , ? ) " , LST_Valeurs )

BDD_Connexion.commit ( )

BDD_Connexion.execute ( " SELECT * FROM numeros " )

BDD_Connexion.close ( )