Cet objet vous permet d'établir une connexion à une base SQL de type MySQL, PostgreSQL, SQLite et autres.

Fontion de construction.

var myObject = new Sql(driver);

1. driver - (Driver) le pilote de la base de données à utiliser

• (NoDatabaseDriverError) aucun pilote de base de données renseigné

Créer un objet Sql utlisant une base de données MySQL.

var myObject = new Sql(Sql.MySQL);

Les pilotes MySQL, PostgreSQL, SQLite 3, Firebird et ODBC sont installés par défaut sur Windows uniquement. Pour voir tous les pilotes disponibles il vous faut appeler la fonction drivers.

Renvoie une liste des Pilotes disponibles.

Sql.drivers();

Ouvrir une connexion avec une base de données.

myObject.connect(parameters);

1. parameters - (object) les paramètres de connexion
   • hostName - (string) le nom de l'hébergement
   • port - (integer) le port à utiliser (utilise le port par défaut si non définit)
   • databaseName - (string) le nom de la base de données (Quand vous utilisez SQLite c'est le nom de fichier de votre base de données)
   • userName - (string) le nom d'utilisateur
   • password - (string) le mot de passe
   • options - (string) les options de connexion (voir http://doc.qt.nokia.com/latest/qsqldatabase.html#setConnectOptions)

• (Sql) ce Sql

• (DatabaseDriverUnavailableError) ce pilote n'est pas disponible
• (ConnectionError) échec de connexion

Préparer une requête sur la base de données actuelle.

myObject.prepare(queryString, parameters);

1. queryString - (string) le "string" de requête à préparer
2. parameters - (object) les paramètres de préparation

• (Sql) ce Sql

• (PrepareQueryError) ne parvient pas à préparer la requête

myObject.prepare("INSERT INTO myTable (id, data) VALUES(:id, :data)", {
	id: 1,
	data: "My data"
});

Exécuter une requête préparée ou exécuter une requête sur la base de données actuelle.

myObject.execute(queryString);

myObject.execute();

1. queryString - (string) le "string" de requête à exécuter

• (Sql) ce Sql

• (ExecuteQueryError) l'exécution de la requête a échoué

Retrouver le résultat d'une requête précédemment exécutée.

myObject.fetchResult(indexStyle);

myObject.fetchResult();

1. indexStyle - (IndexStyle) le style d'indexation de restitution

• (Sql) ce Sql

• (FetchError) ne peut restituer le résultat d'une requête non sélectionnée

Déconnecter de la base de données actuelle.

myObject.disconnect();

• (Sql) ce Sql

Les pilotes SQL. Les pilotes MySQL, PostgreSQL, SQLite 3, Firebird et ODBC sont installés par défaut sur Windows uniquement.

1. SQLite2: SQLite 2
2. SQLite: SQLite 3
3. PostgreSQL: PostgreSQL (versions 7.3 et supérieur)
4. MySQL: MySQL
5. ODBC: Open Database Connectivity (ODBC) - Microsoft SQL Serveur et autre base de données conforme ODBC
6. InterBase: Borland InterBase (Firebird)
7. OCI: Oracle Call Interface Driver
8. TDS: Sybase Adaptive Server (obsolète)
9. DB2: IBM DB2 (version 7.1 et supérieur)

Retrouver le style d'un index.

1. IndexNumber: indexe les résultats par numéro
2. IndexName: indexe les résultats par colonne nom