Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Avancé

Bases de données SQLite en MQL5 : DatabaseOpen, requêtes préparées et transactions

MQL5 embarque le moteur SQLite : créez une base avec DatabaseOpen, insérez vos transactions avec des requêtes préparées et des transactions SQL, puis analysez vos résultats de trading avec de simples requêtes SELECT.

Mis à jour le 23 octobre 2026Lecture : 9 minPar Alix, OptiBot Trading

MQL5 intègre le moteur de base de données SQLite : une base entière tient dans un seul fichier, sans serveur à installer. Vous ouvrez ou créez la base avec DatabaseOpen("trades.sqlite", DATABASE_OPEN_READWRITE|DATABASE_OPEN_CREATE), vous exécutez les ordres SQL sans résultat (création de table, insertion simple) avec DatabaseExecute, et vous lisez des résultats en préparant une requête avec DatabasePrepare, en parcourant les lignes avec DatabaseRead et en extrayant chaque colonne avec DatabaseColumnDouble, DatabaseColumnInteger ou DatabaseColumnText. Pour les insertions en masse, entourez-les d’une transaction : c’est la recommandation officielle et la différence de vitesse est considérable.

Cette page appartient à la rubrique MQL5 avancé. Si vous n’avez besoin que d’exporter quelques lignes vers un tableur, la page Lire et écrire des fichiers CSV suffit. SQLite devient intéressant dès que vous voulez filtrer, agréger, joindre ou conserver un historique volumineux.

Les fonctions Database de MQL5

La documentation recense près de trente fonctions. Les plus utilisées se répartissent ainsi :

RôleFonctions
Ouvrir, fermerDatabaseOpen, DatabaseClose
Exécuter sans résultatDatabaseExecute
Requêtes avec résultatDatabasePrepare, DatabaseRead, DatabaseReadBind, DatabaseFinalize
ParamètresDatabaseBind, DatabaseBindArray, DatabaseReset
Lire une colonneDatabaseColumnInteger, DatabaseColumnLong, DatabaseColumnDouble, DatabaseColumnText, DatabaseColumnBlob
MétadonnéesDatabaseColumnsCount, DatabaseColumnName, DatabaseColumnType, DatabaseTableExists
TransactionsDatabaseTransactionBegin, DatabaseTransactionCommit, DatabaseTransactionRollback
Import, export, affichageDatabaseImport, DatabaseExport, DatabasePrint

DatabasePrint mérite d’être connue dès le départ : elle affiche une table ou le résultat d’une requête dans le journal des experts, ce qui est idéal pour vérifier vos données pendant le développement. DatabaseExport enregistre une table ou une requête dans un fichier CSV.

Ouvrir une base : DatabaseOpen

La signature est int DatabaseOpen(string filename, uint flags). Elle renvoie un handle de base, ou INVALID_HANDLE en cas d’échec. Le nom de fichier est relatif au dossier MQL5\Files, comme pour les fichiers classiques ; sans extension, .sqlite est ajouté automatiquement. Les drapeaux de ENUM_DATABASE_OPEN_FLAGS sont :

  • DATABASE_OPEN_READONLY : lecture seule ;
  • DATABASE_OPEN_READWRITE : lecture et écriture (mode utilisé si aucun des deux n’est précisé) ;
  • DATABASE_OPEN_CREATE : crée le fichier s’il n’existe pas ;
  • DATABASE_OPEN_MEMORY : crée la base en mémoire vive ;
  • DATABASE_OPEN_COMMON : utilise le dossier commun à tous les terminaux.

Deux noms spéciaux existent : ":memory:" crée une base en mémoire, détruite à la fermeture ; NULL ou une chaîne vide crée un fichier temporaire supprimé à la fermeture. Une base en mémoire est très rapide mais n’est accessible qu’au programme qui l’a créée.

Requêtes préparées et paramètres

Une requête préparée se crée avec int DatabasePrepare(int database, string sql, ...). Le texte SQL peut contenir des paramètres ?1, ?2… substitués automatiquement par les arguments supplémentaires, ou liés ensuite avec DatabaseBind(request, index, valeur). Attention à un décalage documenté : dans DatabaseBind, l’index commence à zéro, alors que les paramètres SQL sont numérotés à partir de un. Le paramètre ?1 correspond donc à l’index 0.

Pour exécuter la même requête avec d’autres valeurs, appelez DatabaseReset, liez les nouvelles valeurs, puis relancez. Lier une valeur sur une requête déjà exécutée sans réinitialisation renvoie l’erreur ERR_DATABASE_NOT_READY (5128). Quand vous avez terminé, libérez la requête avec DatabaseFinalize.

La lecture des résultats suit toujours le même schéma : while(DatabaseRead(req)), puis une fonction DatabaseColumn... par colonne. Chacune prend le handle de requête, l’index de la colonne (à partir de zéro) et une variable passée par référence, et renvoie true en cas de succès. Par exemple : bool DatabaseColumnDouble(int request, int column, double &value).

Les requêtes paramétrées ne sont pas qu’une question de confort : elles évitent les erreurs de format (séparateur décimal, apostrophes dans un commentaire d’ordre) qu’introduit la concaténation de chaînes SQL.

Exemple complet : stocker et analyser ses transactions

Le script crée une table, y insère les sorties de position des 90 derniers jours dans une transaction, puis calcule par symbole le nombre de trades, le résultat net et le taux de réussite.

//+------------------------------------------------------------------+
//| DealsToSqlite.mq5 : historique de trades dans une base SQLite    |
//+------------------------------------------------------------------+
#property script_show_inputs
input int    InpDays=90;
input string InpDb  ="journal.sqlite";     // relatif à MQL5\Files

void OnStart()
  {
   int db=DatabaseOpen(InpDb,DATABASE_OPEN_READWRITE|DATABASE_OPEN_CREATE);
   if(db==INVALID_HANDLE)
     {
      Print("DatabaseOpen : erreur ",GetLastError());
      return;
     }
   //--- 1. schéma : la clé primaire évite les doublons à chaque exécution
   if(!DatabaseExecute(db,"CREATE TABLE IF NOT EXISTS deals("
                          "ticket INTEGER PRIMARY KEY, time INTEGER, symbol TEXT,"
                          "magic INTEGER, volume REAL, profit REAL)"))
     {
      Print("CREATE TABLE : erreur ",GetLastError());
      DatabaseClose(db);
      return;
     }
   //--- 2. insertion dans une transaction
   if(HistorySelect(TimeCurrent()-InpDays*86400,TimeCurrent()))
     {
      int req=DatabasePrepare(db,"INSERT OR IGNORE INTO deals VALUES(?1,?2,?3,?4,?5,?6)");
      if(req!=INVALID_HANDLE && DatabaseTransactionBegin(db))
        {
         bool ok=true;
         for(int i=0;i<HistoryDealsTotal() && ok;i++)
           {
            ulong t=HistoryDealGetTicket(i);
            if(t==0 || HistoryDealGetInteger(t,DEAL_ENTRY)!=DEAL_ENTRY_OUT) continue;
            DatabaseReset(req);                                  // réutiliser la requête
            ok=DatabaseBind(req,0,(long)t)                       // ?1 -> index 0
             && DatabaseBind(req,1,HistoryDealGetInteger(t,DEAL_TIME))
             && DatabaseBind(req,2,HistoryDealGetString(t,DEAL_SYMBOL))
             && DatabaseBind(req,3,HistoryDealGetInteger(t,DEAL_MAGIC))
             && DatabaseBind(req,4,HistoryDealGetDouble(t,DEAL_VOLUME))
             && DatabaseBind(req,5,HistoryDealGetDouble(t,DEAL_PROFIT)
                                  +HistoryDealGetDouble(t,DEAL_SWAP)
                                  +HistoryDealGetDouble(t,DEAL_COMMISSION));
            if(ok) DatabaseRead(req);                            // exécute l'INSERT
           }
         if(ok) DatabaseTransactionCommit(db);
         else  { DatabaseTransactionRollback(db); Print("Insertion annulée : ",GetLastError()); }
        }
      if(req!=INVALID_HANDLE) DatabaseFinalize(req);
     }
   //--- 3. analyse par symbole
   int q=DatabasePrepare(db,"SELECT symbol, COUNT(*), SUM(profit),"
                            " 100.0*SUM(profit>0)/COUNT(*) FROM deals"
                            " GROUP BY symbol ORDER BY SUM(profit) DESC");
   if(q==INVALID_HANDLE)
     {
      Print("SELECT : erreur ",GetLastError());
      DatabaseClose(db);
      return;
     }
   while(DatabaseRead(q))
     {
      string sym; int n; double net,win;
      DatabaseColumnText(q,0,sym);
      DatabaseColumnInteger(q,1,n);
      DatabaseColumnDouble(q,2,net);
      DatabaseColumnDouble(q,3,win);
      PrintFormat("%-10s %4d trades  net %10.2f  gagnants %5.1f %%",sym,n,net,win);
     }
   DatabaseFinalize(q);
   DatabaseClose(db);
  }

Le résultat net inclut ici swap et commission, ce qui donne une image plus fidèle que le seul profit brut. La clause INSERT OR IGNORE combinée à la clé primaire sur le ticket permet de relancer le script chaque jour sans créer de doublons. Pour comprendre les propriétés de transactions utilisées, voyez Lire l’historique des ordres et transactions.

Concevoir un schéma simple et durable

Avant d’écrire la première ligne de code, prenez quelques minutes pour définir vos tables. Quelques règles suffisent dans la plupart des projets de trading :

  • Une clé naturelle : le ticket de transaction ou d’ordre est unique côté serveur ; utilisez-le comme clé primaire plutôt qu’un compteur artificiel.
  • Les dates en secondes : stockez les datetime sous forme d’entier. Les comparaisons et les tris sont alors immédiats, et la conversion vers un texte lisible se fait au moment de l’affichage avec TimeToString.
  • Des montants déjà agrégés : enregistrer le résultat net (profit, swap et commission) évite de refaire l’addition dans chaque requête d’analyse.
  • Un index sur les colonnes filtrées : si vous interrogez souvent par magic number ou par symbole, un CREATE INDEX sur ces colonnes accélère nettement les requêtes quand la table grossit.
  • Une version de schéma : une petite table de paramètres contenant un numéro de version vous permettra de faire évoluer la structure sans casser les bases existantes.

Pourquoi les transactions accélèrent tout

Sans transaction explicite, SQLite valide chaque INSERT individuellement sur le disque. Avec DatabaseTransactionBegin puis DatabaseTransactionCommit, toutes les insertions sont écrites en une fois. La documentation recommande explicitement les transactions pour les modifications en masse sur une base disque. En cas d’erreur au milieu du lot, DatabaseTransactionRollback annule tout : la base reste cohérente, sans moitié de lot inséré.

Cas d’usage en trading

  • Journal de trading consolidé : plusieurs EA écrivent dans la même base (via DATABASE_OPEN_COMMON), vous analysez ensuite par magic number, symbole, heure ou jour de la semaine.
  • Résultats d’optimisation : stocker paramètres et statistiques de chaque passe, puis rechercher les plateaux de paramètres stables par une simple requête. La collecte des passes est expliquée dans Frames : exporter les résultats d’optimisation.
  • Cache de calculs : conserver des statistiques longues à calculer pour ne pas les recalculer à chaque démarrage.
  • Données de référence : niveaux, sessions ou calendriers propres à votre stratégie.

Pièges fréquents

  • Oublier DatabaseFinalize : chaque requête préparée doit être libérée, sinon les ressources s’accumulent.
  • Index de DatabaseBind : il commence à zéro alors que ?1 est le premier paramètre SQL.
  • Types SQLite : SQLite est souple sur les types ; lisez chaque colonne avec la fonction adaptée (DatabaseColumnLong pour un ticket ou une date en secondes, par exemple).
  • Écriture à chaque tick : regroupez les écritures et utilisez des transactions.
  • Base introuvable en backtest : comme les fichiers, elle est créée dans le dossier de l’agent de test, sauf avec DATABASE_OPEN_COMMON.

Questions fréquentes

Faut-il installer SQLite pour utiliser les fonctions Database ?

Non. Le moteur SQLite est intégré à MetaTrader 5. La base est un simple fichier dans MQL5\Files, que vous pouvez aussi ouvrir avec n’importe quel outil compatible SQLite, y compris depuis MetaEditor.

Quelle différence entre DatabaseExecute et DatabasePrepare ?

DatabaseExecute exécute directement un ordre SQL et renvoie seulement un succès ou un échec : idéal pour CREATE, INSERT simple, UPDATE ou DELETE. DatabasePrepare crée une requête réutilisable, avec paramètres, dont vous parcourez les résultats avec DatabaseRead.

Comment éviter les doublons quand je relance mon export ?

Déclarez une clé primaire ou un index unique sur l’identifiant (le ticket de transaction) et utilisez INSERT OR IGNORE. Les lignes déjà présentes sont alors ignorées.

Plusieurs EA peuvent-ils écrire dans la même base ?

Oui, en ouvrant le même fichier, par exemple dans le dossier commun avec DATABASE_OPEN_COMMON. Gardez des transactions courtes pour limiter les conflits d’accès simultanés.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.