Configurar o tempo limite de consulta para o construtor de API de Dados

Erros de tempo limite de consulta ocorrem quando as operações de banco de dados excedem o tempo limite configurado. O construtor de API de dados não tem uma configuração de tempo limite global: você configura tempos limite por meio de sua cadeia de conexão de banco de dados ou configurações específicas do MCP.

Observação

Não há nenhuma runtime.query-timeout ou configuração semelhante no arquivo de configuração do DAB. Configure tempos limite usando parâmetros de cadeia de conexão específicos do banco de dados.

Configuração de tempo limite do banco de dados

Configure o tempo limite adicionando o parâmetro apropriado à cadeia de conexão. O tempo limite se aplica aos pontos de extremidade REST, GraphQL e MCP (Model Context Protocol).

Importante

O aumento de tempos limite pode mascarar problemas de desempenho. Otimize consultas, adicione índices e implemente a paginação antes de elevar os limites de tempo limite.

SQL Server

Adicione Command Timeout=<seconds> à cadeia de conexão:

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

Padrão do provedor: 30 segundos

PostgreSQL

Adicione CommandTimeout=<seconds> à cadeia de conexão:

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

Padrão do provedor: 30 segundos

MySQL

Adicione DefaultCommandTimeout=<seconds> à cadeia de conexão:

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

Padrão do provedor: 30 segundos

Cosmos DB

As configurações de nível de serviço (não parâmetros de cadeia de conexão) controlam o tempo limite do 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 consultas de longa execução, considere:

• Otimização da estratégia de particionamento
• Otimização de consulta com índices
• Usando tokens de continuação para grandes conjuntos de resultados

Tempo limite de registros agregados do MCP

As operações MCP usam o tempo limite da cadeia de conexão e um tempo limite adicional específico do MCP. O que for mais curto dispara primeiro.

Observação

O aggregate-records recurso faz parte do Construtor de API de Dados 2.0, que está atualmente em versão prévia.

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