DESCRIPTION.

Créer un nouvel objet connexion avec une base de données.

SYNTAXE.

BDD_Basse = sqlite3.Connection ( base , attribut1 = valeur , ... , attributn = valeur )

BDD_Basse = ⇨ affectation de l'instance de connexion [ optionnel ]

sqlite3.Connection ( ) ⇨ création d'une instance de tkinter.Connection ( ) [ OBLIGATOIRE ]

base ⇨ fichier désignant la base de données [ OBLIGATOIRE ]

attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur [ optionnel ]

GENERALITES. 

La classe sqlite3.Connection ( ) crée des objets connexions, qui permettent de dialoguer avec une base de données spécifique,

L'appel du constructeur de classe sqlite3.Connection ( ) attend comme argument le nom du fichier contenant la base de données. Le nom de fichier peut être relatif (dans le répertoire de travail actuel) ou absolu (dans un autre répertoire). Si le fichier n'existe pas, à l'emplacement indiqué, il sera créer automatiquement.

Vous disposez aussi de la possibilité de travailler avec une base de données éphémère, en mémoire vive, en donnant la valeur ":memory:" à la place d'un nom de fichier. Dans ce cas, la base de données sera détruite à la fermeture du programme.

La méthode sqlite3.Connection ( ).commit ( ), devra être appelée pour enregistrer toutes les modifications apportées à votre base de données, sinon les changements ne seront pas pris en compte.

Corresponds à la méthode sqlite3.connect ( ) du module sqlite3, dont l'utilisation lui est préférable.

Aller à tutoriel du module sqlite3.

Aller à présentation des commandes SQL.

LISTE DES ATTRIBUTS DE LA CLASSE CONNECTION. 

autocommit : controle le comportement des transactions conformes à la norme PEP 249.

cached_statements : modifie le nombre d'instructions qui peuvent être présentes dans le tampon de l'objet-connexion.

check_same_thread : autorise ou non d'autres connexions avec la base de données liés à cet objet-connexion.

detect_types :  autorise ou non, les convertisseurs de types de données définit par l'utilisateur, en plus des 5 types natifs.

factory : défini une autre classe de connexion pour la base de données.

in_transaction : indique si des modifications sont en attente dans la mémoire tampon, ou si elles toutes sont enregistrées.

isolation_level : modifie le niveau d'isolement : None (pour autocommit) ; "deferred" ; "immediate" ou exclusive".

lastrowid : retourne l'Id de l'enregistrement qui a été modifié en dernier.

rowcount : retourne le nombre d'enregistrements qui ont été modifiés ou créés depuis le début de la connexion actuelle.

row_factory : retourne les valeurs des champs dans un objet-ligne au lieu d'un tuple ( ).

text_factory : retourne les valeurs TEXT sous forme de bytes ( ) au lieu de str ( ).

timeout : définie le temps d'attente de la connexion avant la validation définitive d'une commande, en cas de multi-connexions.

total_changes : indique le nombre de modifications apportées à la bases de données depuis le début connexion actuelle.

uri : interprète ou non la base de données comme une URI, ce qui permet de définir des option (liées au URI) supplémentaires.

LISTE DES METHODES DE LA CLASSE CONNECTION. 

backup ( ) : créer une copie d'une base de données.

blobopen ( ) : crée un nouvel un objet BLOB et ouvre un liaison avec lui.

close ( ) : arrête la liaison entre un objet connexion et sa base de données.

commit ( ) : transfère les modifications en attente dans la base de données. 

create_aggregate ( ) : lie un mot à une une classe, pour effectuer un traitement individuel de toutes les lignes.

create_collation ( ) : lie un mot à une une fonction, pour effectuer un classement personnalisé toutes les lignes.

create_function ( ) : lie un mot à une fonction, qui pourra être appelée pour retourner une valeur dans une requête.

create_window_function ( ) : lie un mot à une classe, pour des traitements individuels et collectifs des lignes.

cursor ( ) : crée un objet curseur pour accéder aux tables de la base de données.

deserialize ( ) : convertie un objet bytes ( ), compatible, en une base de données et la place en mémoire.

enable_load_extension ( ) : indique si le script peut charger de nouvelles extensions SQL.

execute ( ) : exécute une commande SQL en relation avec la base de données. 

executemany ( ) : exécute une commande SQL autant de fois qu'il y a d'enregistrements à modifier. 

executescript ( ) : exécute plusieurs commandes SQL en relation avec la base de données.

getconfig ( ) : retourne la valeur d'une option de configuration de connexion à une base de données.

getlimit ( ) : retourne la valeur d'une limitation imposée aux bases de données du standard SQL.

interrupt ( ) : bloque l'utilisation de l'objet connexion pour des requête provenant d'autres fils d'exécution.

iterdump ( ) : retourne une représentant la composition de la base de données dans un itérable.

load_extension ( ) : charge une nouvelle extension SQL.

rollback ( ) : efface, sans la sauvegarder, la mémoire tampon liée à la base de données.

serialize ( ) : retourne un objet bytes ( ) correspondant au contenu de la base de données sous forme de fichier.

set_authorizer ( ) : indique la fonction autorisant ou non une action sur une base de données.

set_progress_handler ( ) : indique une fonction à exécuter après d'un certain nombre de commandes SQL.

set_trace_callback ( ) : indique une fonction à exécuter chaque commande SQL est effectuée.

setconfig ( ) : modifie la valeur d'une option de configuration de connexion à une base de données.

setlimit ( ) : modifie la valeur d'une limitation imposée aux bases de données du standard SQL.