データ API ビルダーのクエリ タイムアウトを構成する

データベース操作が構成されたタイムアウトを超えると、クエリ タイムアウト エラーが発生します。 データ API ビルダーにはグローバル タイムアウト設定がありません。データベース接続文字列または MCP 固有の設定を使用してタイムアウトを構成します。

注

DAB 構成ファイルには runtime.query-timeout または同様の設定はありません。 データベース固有の接続文字列パラメーターを使用してタイムアウトを構成します。

データベース タイムアウトの構成

接続文字列に適切なパラメーターを追加して、タイムアウトを構成します。 タイムアウトは、REST、GraphQL、およびモデル コンテキスト プロトコル (MCP) エンドポイントに適用されます。

Important

タイムアウトを増やすと、パフォーマンスの問題が隠される可能性があります。 タイムアウト制限を引き上げる前に、クエリの最適化、インデックスの追加、改ページの実装を行います。

SQL Server

接続文字列に Command Timeout=<seconds> を追加します。

{
  "data-source": {
    "database-type": "mssql",
    "connection-string": "Server=myServer;Database=myDb;Trusted_Connection=True;Encrypt=True;Command Timeout=240;"
  }
}

プロバイダーの既定値: 30 秒

PostgreSQL

接続文字列に CommandTimeout=<seconds> を追加します。

{
  "data-source": {
    "database-type": "postgresql",
    "connection-string": "Host=myServer;Database=myDb;Username=myUser;Password=myPassword;CommandTimeout=240"
  }
}

プロバイダーの既定値: 30 秒

MySQL

接続文字列に DefaultCommandTimeout=<seconds> を追加します。

{
  "data-source": {
    "database-type": "mysql",
    "connection-string": "Server=myServer;Database=myDb;User=myUser;Password=myPassword;DefaultCommandTimeout=240"
  }
}

プロバイダーの既定値: 30 秒

Cosmos DB

サービス レベルの設定 (接続文字列パラメーターではない) は、Cosmos DB のタイムアウトを制御します。

{
  "data-source": {
    "database-type": "cosmosdb_nosql",
    "options": {
      "database": "myDatabase",
      "container": "myContainer"
    },
    "connection-string": "AccountEndpoint=https://myaccount.documents.azure.com:443/;AccountKey=myKey;"
  }
}

実行時間の長いクエリの場合は、次の点を考慮してください。

• パーティション分割戦略の最適化
• インデックスを使用したクエリの最適化
• 大規模な結果セットに継続トークンを使用する

MCP アグリゲートレコードのタイムアウト

MCP 操作では、接続文字列のタイムアウトと追加の MCP 固有のタイムアウトの両方が使用されます。 短い方が先に作動します。

注

aggregate-records機能は、現在プレビュー段階にある Data API Builder 2.0 の一部です。

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "aggregate-records": {
          "query-timeout": 120
        }
      }
    }
  }
}