查詢逾時錯誤發生在資料庫操作超過設定逾時時。 Data API Builder 沒有全域逾時設定——你透過資料庫連線字串或 MCP 專屬設定來設定逾時。
備註
DAB 設定檔裡沒有 runtime.query-timeout 類似的設定。 使用資料庫特定連線字串參數來設定逾時參數。
資料庫超時設定
透過在連線字串中加入適當的參數來設定逾時。 逾時適用於 REST、GraphQL 及模型上下文協定(MCP)端點。
這很重要
增加逾時時間可以掩蓋效能問題。 在提高逾時限制前,先優化查詢、新增索引並實作分頁。
請在連接字串中加入 Command Timeout=<seconds>:
{
"data-source": {
"database-type": "mssql",
"connection-string": "Server=myServer;Database=myDb;Trusted_Connection=True;Encrypt=True;Command Timeout=240;"
}
}
供應商預設:30秒
MCP 總計紀錄逾時
MCP 操作同時使用連線字串逾時及額外的 MCP 專用逾時。 較短的先觸發。
備註
此功能 aggregate-records 可在 Data API 建構器 2.0 及更新版本中使用。
{
"runtime": {
"mcp": {
"dml-tools": {
"aggregate-records": {
"query-timeout": 120
}
}
}
}
}