DESCRIPTION.

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

SYNTAXE.

BYT_Base = BDD_Base.serialize ( * , base )

BYT_Base = ⇨ variable qui recevra le nouvel objet bytes ( ) [ optionnel ]

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

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

* ⇨ paramètres optionnels [ optionnel ]

base ⇨ identification de la base de données [ optionnel ]

REMARQUES. 

base doit être le nom d'une base de données, "main", ":memory:" ou "temp", valide. Si base est omis, c'est la base de données principale, "main", qui sera pris par défaut.

L'appel de la méthode objet.serialize ( ) transférera une base de données dans un objet de type bytes ( ). Si base est déjà sous la forme d'un fichier sur disque ordinaire, la sérialisation est simplement une copie du fichier disque. Si base une base de données en mémoire, ":memory:", ou une base de données temporaire, "temp", la sérialisation est la même séquence d'octets qui serait écrite sur le disque si cette base de données était sauvegardée sur le disque.

Remarque Cette méthode n'est disponible que si la bibliothèque SQLite sous-jacente dispose de l'API de sérialisation.

Voir la méthode objet.deserialize ( ) qui permet de restituer un objet bytes ( ), compatible, en une base de données en mémoire.

EXEMPLE. 

import sqlite3

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

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

BDD_Connexion.execute ( " CREATE TABLE IF NOT EXISTS premiers ( nombre INTEGER ) " )

BDD_Connexion.executemany ( " INSERT INTO premiers ( nombre ) VALUES ( ? ) " , LST_Valeurs )

BDD_Connexion.commit ( )

BYT_Base = BDD_Base.serialize ( )

print ( BYT_Base )

BDD_Connexion.executemany ( " INSERT INTO premiers ( nombre ) VALUES ( ? ) " , [ ( 11 , ) , ( 13 , ) , ( 17 , ) , ( 19 , ) ] )

BDD_Connexion.commit ( )

BDD_Base.deserialize ( BYT_Base )

print ( BDD_Connexion.execute ( " SELECT * FROM premiers " ).fetchall ( ) )

BDD_Connexion.close ( )