Dynamique.js - Documentation JSQL.insertInto

Version:
Dernière mise à jour le 28/08/2018.

JSQL.insertInto

Insère des données en base de données.

Synthaxe


						JSQL.insertInto(dbName, desc[, version]);

Si vous êtes amenés à insérer, supprimer ou modifier régulièrement des données d'une base de données, vous pouvez utiliser les méthodes fournies par la méthode JSQL. Des gains de performance pourront être observés du fait de la non-recherche de la version de la base de données à chaque manipulation.

Où:

dbName : nom de la base de données à laquelle il faut insérer des données;
desc : objet définissant l'insertion tel que:
- into : table dans laquelle les données doivent être insérées. Dans l'API IndexedDB, on parle de magasin (store) et non de table.
- data : tableau d'objet contenant les données à insérer;
- upsert : indique si les données doivent être mise à jour si possible ou uniquement insérées.
version Facultatif: version de la base de données à utiliser, sous format système. Reportez-vous à la section Versionnage et délais maximum de transaction pour plus de détails sur les formats des versions. Par défaut, la version retournée par la méthode getDatabaseVersion sera utilisée.

Valeur de retour

Une promesse (Promise) est retournée. Celle-ci sera résolue lorsque la requête d'insertion sera terminée. La valeur fournie comme valeur de résolution sera true si l'opération à réussie ou false dans le cas contraire.

Exemple

Exemple 1: Insertion de données

L'exemple ci-dessous insère des données en base de données.


							(async function() {
								/* la base est supposée créer */
								
								const insert = await JSQL.insertInto("DB-TEST", {
									into 	: "myTable", 	// Pour l'API IndexedDB, on parle normalement de magasin ("store") et non de table
									upsert 	: false,		// Indique si les données doivent être mise à jour (true) ou juste insérées (false)
									data	: [{
										id : 12,
										colum : "value"
									}/*, ... */]
								});
								
								if(insert) {
									alert("Insertion réussie !");
								}
								else {
									alert("Erreur !");
								}
							})();

Compatibilité

La prise en charge des Promise est nécessaire ainsi que le support de l'API IndexedDB.