DESCRIPTION.

Indique une fonction à exécuter chaque fois qu'une instruction de commande SQL est effectuée.

SYNTAXE.

BDD_Base.set_trace_callback ( fonction )

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

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

fonction ⇨ méthode à exécuter [ 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.

fonction sera appelée chaque que fois qu'une instruction de commande a été exécuté. La définition de fonction doit prévoir de recevoir un argument de type str ( ). fonction ne retourne aucune valeur à l'instruction appemante.

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_Action ( Q ) :

print ( "Exécution de :" , Q )

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

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

BDD_Connexion.set_trace_callback ( FNC_Action )

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.execute ( " SELECT * FROM premiers " )

BDD_Connexion.close ( )