为数据 API 生成器配置查询超时

当数据库操作超过配置的超时时间时，会发生查询超时错误。 数据 API 生成器没有全局超时设置 - 通过数据库连接字符串或 MCP 特定的设置配置超时。

注释

DAB 配置文件中没有 runtime.query-timeout 或类似的设置。 使用数据库专用连接字符串参数配置超时设置。

数据库超时配置

通过将相应的参数添加到连接字符串来配置超时。 超时适用于 REST、GraphQL 和模型上下文协议 （MCP） 终结点。

重要

增加超时可能会掩盖性能问题。 在提高超时限制之前优化查询、添加索引并实现分页。

Sqlserver

将 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 是数据 API 生成器 2.0 的一部分，目前以预览版提供。

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