Configuración del tiempo de espera de consulta para Data API Builder

Los errores de tiempo de espera de consulta se producen cuando las operaciones de base de datos superan el tiempo de espera configurado. Data API Builder no tiene una configuración de tiempo de espera global: se configuran los tiempos de espera a través de la cadena de conexión de la base de datos o la configuración específica de MCP.

Nota:

No hay ninguna configuración runtime.query-timeout o similar en el archivo de configuración de DAB. Configure los tiempos de espera mediante parámetros de cadena de conexión específicos de la base de datos.

Configuración del tiempo de espera de la base de datos

Configure el tiempo de espera agregando el parámetro adecuado a la cadena de conexión. El tiempo de espera se aplica a los puntos de conexión REST, GraphQL y Model Context Protocol (MCP).

Importante

El aumento de los tiempos de espera puede enmascarar los problemas de rendimiento. Optimice las consultas, agregue índices e implemente la paginación antes de aumentar los límites de tiempo de espera.

SQL Server

Agregue Command Timeout=<seconds> a la cadena de conexión:

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

Valor predeterminado del proveedor: 30 segundos

PostgreSQL

Agregue CommandTimeout=<seconds> a la cadena de conexión:

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

Valor predeterminado del proveedor: 30 segundos

MySQL

Agregue DefaultCommandTimeout=<seconds> a la cadena de conexión:

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

Valor predeterminado del proveedor: 30 segundos

Cosmos DB

La configuración de nivel de servicio (no los parámetros de cadena de conexión) controla el tiempo de espera de Cosmos DB:

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

Para las consultas de larga duración, tenga en cuenta lo siguiente:

• Optimización de la estrategia de creación de particiones
• Optimización de consultas con índices
• Uso de tokens de continuación para conjuntos de resultados grandes

Tiempo de espera para el procesamiento de registros agregados del MCP

Las operaciones de MCP usan el tiempo de espera de la cadena de conexión y un tiempo de espera adicional específico para MCP. El que sea más corto se activa primero.

Nota:

La aggregate-records característica forma parte de Data API Builder 2.0, que se encuentra actualmente en versión preliminar.

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