Konfigurieren des Abfragetimeouts für den Daten-API-Generator

Abfragetimeoutfehler treten auf, wenn Datenbankvorgänge das konfigurierte Timeout überschreiten. Der Daten-API-Generator verfügt nicht über eine globale Timeouteinstellung– Sie konfigurieren Timeouts über ihre Datenbankverbindungszeichenfolge oder MCP-spezifische Einstellungen.

Hinweis

In der DAB-Konfigurationsdatei gibt es keine runtime.query-timeout oder ähnliche Einstellung. Konfigurieren Sie Timeouts mithilfe datenbankspezifischer Verbindungszeichenfolgenparameter.

Datenbank-Timeout-Konfiguration

Konfigurieren Sie den Timeout, indem Sie der Verbindungszeichenfolge den entsprechenden Parameter hinzufügen. Das Timeout gilt für REST-, GraphQL- und Model Context Protocol (MCP)-Endpunkte.

Von Bedeutung

Durch die Erhöhung von Timeouts können Leistungsprobleme verdeckt werden. Optimieren Sie Abfragen, fügen Sie Indizes hinzu und implementieren Sie Paginierung, bevor Sie Zeitlimits erhöhen.

SQL Server

Fügen Sie Command Timeout=<seconds> zu Ihrer Verbindungszeichenfolge hinzu.

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

Anbieterstandard: 30 Sekunden

PostgreSQL

Fügen Sie CommandTimeout=<seconds> zu Ihrer Verbindungszeichenfolge hinzu.

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

Anbieterstandard: 30 Sekunden

MySQL

Fügen Sie DefaultCommandTimeout=<seconds> zu Ihrer Verbindungszeichenfolge hinzu.

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

Anbieterstandard: 30 Sekunden

Cosmos DB

Einstellungen auf Dienstebene (keine Verbindungszeichenfolgenparameter) steuern Cosmos DB-Timeout:

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

Bei lang andauernden Abfragen sollten Sie Folgendes berücksichtigen:

• Optimierung der Partitionierungsstrategie
• Abfrageoptimierung mit Indizes
• Verwenden von Fortsetzungstoken für große Resultsets

MCP-Zeitüberschreitung für Aggregatdatensätze

MCP-Vorgänge verwenden sowohl das Timeout der Verbindungszeichenfolge als auch ein zusätzliches MCP-spezifisches Timeout. Je nachdem, was kürzer ist, wird zuerst ausgelöst.

Hinweis

Das aggregate-records Feature ist Teil des Daten-API-Generators 2.0, der sich derzeit in der Vorschau befindet.

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