DESCRIPTION.

Exécute une commande SQL en relation avec la base de données. 

SYNTAXE.

BDD_Base.execute ( commande , valeurs )

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

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

commande ⇨ commande SQL [ OBLIGATOIRE ]

valeurs ⇨ liste des valeurs de remplacement [ OBLIGATOIRE ]

REMARQUES. 

commande doit être un str ( ) à la syntaxe stricte d'un commande SQL valide.

valeurs doit être un tuple ( ) contenant autant d'éléments que commande a de valeurs de remplacement. Les éléments 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.execute ( ) ne réalise qu'une seule commande SQL. Si plusieurs enregistrements doivent être modifiés ou créer, il convient d'utiliser la méthode objet.executemany ( ).

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 méthode objet.execute ( ) crée un objet curseur anonyme et éphémère, et invoque la méthode curseur.execute ( ) 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 ( "ON - sgbd.db" )

BDD_Connexion.execute ( " CREATE TABLE IF NOT EXISTS Contact ( Prenon TEXT , Nom TEXT , Site TEXT ) " )

kcontact = ( "Origine" , "NERD" , "Mon Python" )

BDD_Connexion.execute ( " INSERT INTO Contact ( Prenon , Nom , Site ) VALUES ( ? , ? , ? ) " , kcontact )

BDD_Connexion.commit ( )

BDD_Connexion.close ( )