DESCRIPTION.

Exécute une commande SQL, autant de fois que nécessaire, en relation avec la base de données. 

SYNTAXE.

BDD_Base.executemany ( commandes , valeurs )

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

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

commande ⇨ commande SQL [ OBLIGATOIRE ]

valeurs ⇨ liste des valeurs de remplacement [ OBLIGATOIRE ]

REMARQUES. 

commande doit être un str ( ) contenant plusieurs commandes SQL valides séparées par un point virgule (;).

valeurs doit être une list ( ) de tuple ( ), contenant autant d'éléments que commande a de valeurs de remplacement. Les éléments dans les tuple ( ) de valeurs doivent être placés dans le même ordre qu'attendu dans commande et du même type que le champ correspondant. 

NE JAMAIS INDIQUER LES VALEURS des champs directement dans l'instruction SQL.

Passez les à l'aide de tuple ( ) ou de list ( ) affectées avant l'appel.

Cela en prévention de tous détournements de donnéesde la part de tiers personnes mal intentionnés.

L'appel de la méthode objet.executemany ( ) réalise plusieurs commandes SQL. Si une seule commande doit être ordonnée on utilisera de préférence la méthode objet.execute ( ).

Les modifications, ou créations, apportées à la base de données doivent être confirmées par la méthode objet.commit ( ) pour être sauvegardées sur le support physique où se trouve la base de données.

L'appel de la commande objet.executemany ( ) crée un objet curseur anonyme et éphémère, et invoque la méthode curseur.executemany ( ) de cet objet curseur pour réaliser la commande.

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

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

BDD_Connexion.execute ( " CREATE TABLE IF NOT EXISTS LesPrix ( Id integer primary key autoincrement unique , Article text not null , PrixHT real , Taux real ) " )

karticles = [ ( "Robe de soirée" , 119.99 , 20.3 ) , ( "Escarpins blancs" , 79.99 , 17.25 ) , ( "Etole satin" , 189.99 , 33.33 ) ] 

BDD_Connexion.executemany ( " INSERT INTO LesPrix ( Article , PrixHT , Taux ) VALUES ( ? , ? , ? ) " , karticles )

BDD_Connexion.commit ( )

BDD_Connexion.close ( )