DESCRIPTION.

Exécute plusieurs commandes SQL en relation avec la base de données. 

SYNTAXE.

BDD_Base.executescript ( commandes )

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

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

commandes ⇨ commande SQL [ OBLIGATOIRE ]

REMARQUES. 

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

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.executescript ( ) 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.executescript ( ) 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:" )

kjoueura = ( "Rick" , 2200 , 4 )

kjoueurb = ( "Jeanne" , 2100 , 2 )

kjoueurc = ( "Marie" , 1800 , 3 )

kjoueurd = ( "Oscar" , 2050 , 3 )

BDD_Test.executescript ( """

    CREATE TABLE IF NOT EXISTS Joueurs ( Nom TEXT , Elo INTEGER , Points INTEGER ) ;

    INSERT INTO Joueurs ( Nom , Elo , Points ) VALUES ( ? , ? , ? ) " , kjoueura ;

    INSERT INTO Joueurs ( Nom , Elo , Points ) VALUES ( ? , ? , ? ) " , kjoueurb ;

    INSERT INTO Joueurs ( Nom , Elo , Points ) VALUES ( ? , ? , ? ) " , kjoueurc ;

    INSERT INTO Joueurs ( Nom , Elo , Points ) VALUES ( ? , ? , ? ) " , kjoueurd ;

    SELECT * FROM Joueurs ORDER BY Points ;

      """ )

BDD_Connexion.commit ( )

BDD_Connexion.close ( )