【MQL5】DatabaseTableExists関数の使い方と自動売買実装コード

1. DatabaseTableExists関数の概要と実務での活用法

MQL5におけるDatabaseTableExists関数は、指定したSQLiteデータベース内に特定のテーブルが存在するかどうかを確認するための「ガード（保護）関数」です。

実務レベルのEA（エキスパートアドバイザー）開発において、データベースは取引履歴の保存、独自のインジケーター値の記録、あるいは複数通貨ペアの相関データの蓄積などに活用されます。しかし、プログラムがテーブルの存在を前提としてSELECTやINSERT文を発行した際、もしテーブルが存在しなければ、ランタイムエラーが発生しEAの動作が停止してしまうリスクがあります。

特に、EAの初回起動時に「テーブルがなければ作成し、あればそのまま使う」という初期化プロセスを安全に行うために、この関数は欠かせません。動的にテーブルを生成するような複雑なロジックを組む際にも、二重作成エラーを防ぐためのチェック機構として非常に重宝します。

2. 構文と戻り値

DatabaseTableExists関数の構文は非常にシンプルです。

bool DatabaseTableExists(
   int           database,     // データベースハンドル
   const string  table_name    // 確認するテーブル名
);

パラメーター

• database: DatabaseOpen()関数によって取得した有効なデータベースハンドルを指定します。
• table_name: 存在を確認したいテーブルの名前を文字列で指定します。

戻り値

• 指定したテーブルが存在する場合は true を返します。
• テーブルが存在しない、もしくはエラーが発生した場合は false を返します。

詳細なエラー理由を知りたい場合は、GetLastError()関数を呼び出すことでエラーコードを確認できます。

3. 具体的な使い方・実践サンプルコード

以下は、EAの初期化時（OnInit）にデータベースを開き、特定のテーブルが存在するか確認し、存在しない場合のみ新規作成する実用的なコード例です。

//+------------------------------------------------------------------+
//| データベースの初期設定を行うサンプル                                     |
//+------------------------------------------------------------------+
int PrepareDatabase()
{
   string filename = "MyTradeData.db";
   string tableName = "TRADE_LOGS";

   // 1. データベースを開く（共通フォルダに作成）
   int dbHandle = DatabaseOpen(filename, DATABASE_OPEN_READWRITE | DATABASE_OPEN_CREATE | DATABASE_OPEN_COMMON);

   if(dbHandle == INVALID_HANDLE)
   {
      Print("データベースのオープンに失敗しました。エラーコード: ", GetLastError());
      return INVALID_HANDLE;
   }

   // 2. テーブルが存在するか確認
   if(!DatabaseTableExists(dbHandle, tableName))
   {
      Print(tableName + " テーブルが存在しません。新規作成します。");

      // 3. テーブルが存在しないので、CREATE TABLE文を実行
      string sql = "CREATE TABLE " + tableName + " ("
                   "ID INTEGER PRIMARY KEY AUTOINCREMENT,"
                   "TIME DATETIME NOT NULL,"
                   "SYMBOL TEXT NOT NULL,"
                   "PROFIT REAL NOT NULL"
                   ");";

      if(!DatabaseExecute(dbHandle, sql))
      {
         Print("テーブル作成失敗。エラー: ", GetLastError());
         DatabaseClose(dbHandle);
         return INVALID_HANDLE;
      }
      Print("テーブルを正常に作成しました。");
   }
   else
   {
      Print(tableName + " テーブルは既に存在します。");
   }

   return dbHandle;
}

// EAの初期化イベント
int OnInit()
{
   int db = PrepareDatabase();
   if(db != INVALID_HANDLE)
   {
      // 後続の処理のためにハンドルを保持、または閉じる
      DatabaseClose(db);
   }
   return(INIT_SUCCEEDED);
}

4. 使用上の注意点とよくあるエラー

開発中につまずきやすいポイントをいくつか挙げます。

1. ハンドルの有効性: DatabaseTableExistsを呼び出す前に、必ずDatabaseOpenが成功しているかを確認してください。無効なハンドル（INVALID_HANDLE）を渡すと、当然ながら結果は常にfalseとなります。
2. 大文字・小文字の区別: SQLite自体はテーブル名の大文字・小文字を区別しない設定が一般的ですが、MQL5のコード内では可読性と予期せぬ挙動を防ぐため、常に一定の命名規則（例：すべて大文字）で記述することを推奨します。
3. データベースのスコープ: DATABASE_OPEN_COMMONフラグを使用している場合、MT5のターミナル間（異なるMT5同士）でデータを共有できます。この際、別のEAがテーブル構成を変更している可能性があるため、操作直前の存在確認はより重要になります。
4. エラーハンドリングの混同: falseが返ってきた際、それが「テーブルがないだけ」なのか「データベース接続が切れたエラー」なのかを判断するために、ログ出力（Print）を活用してデバッグを行いましょう。

5. 【重要】自動売買における約定スピードと環境の罠

アルゴリズムの論理構成が完璧であっても、それを実行する「環境」が貧弱であれば、クオンツとしての戦略は破綻します。多くの開発者が陥る罠が、自宅のPCや一般的な光回線での運用です。FX市場はミリ秒（1000分の1秒）単位で価格が変動しており、自宅PCから海外にある証券会社のサーバーへ注文を出す際、物理的な距離に起因する「ネットワーク遅延（レイテンシ）」が致命的なスリッページを引き起こします。

バックテストでは勝てている戦略がリアル口座で勝てない最大の理由は、この実行速度の差にあります。機関投資家やプロのクオンツが、証券会社のサーバーに物理的に近いデータセンターのVPS（仮想専用サーバー）を利用するのは、もはやマナーではなく勝つための絶対条件です。極限までレイテンシを削り、ミリ秒の優位性を確保して初めて、データベースを活用した高度なアルゴリズムはその真価を発揮します。本気でシストレを運用するなら、専用VPSの導入は避けて通れない投資と言えるでしょう。