Configurar o tempo de espera da consulta para o Data API Builder

Erros de tempo de espera de consulta ocorrem quando as operações da base de dados excedem o tempo limite configurado. O Data API Builder não tem uma definição global de timeout — configura-se os timeout através da cadeia de ligação à base de dados ou das definições específicas do MCP.

Observação

Não existe nenhuma runtime.query-timeout ou uma configuração semelhante no ficheiro de configuração DAB. Configure os timeouts usando parâmetros específicos da cadeia de ligação da base de dados.

Configuração de tempo limite da base de dados

Configure o timeout adicionando o parâmetro apropriado à sua cadeia de ligação. O timeout aplica-se aos endpoints REST, GraphQL e Model Context Protocol (MCP).

Importante

Aumentar os tempos de espera pode mascarar problemas de desempenho. Otimize consultas, adicione índices e implemente paginação antes de aumentar os limites de timeout.

SQL Server

Adicione Command Timeout=<seconds> à sua cadeia de ligação:

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

Padrão do fornecedor: 30 segundos

PostgreSQL

Adicione CommandTimeout=<seconds> à sua cadeia de ligação:

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

Padrão do fornecedor: 30 segundos

MySQL

Adicione DefaultCommandTimeout=<seconds> à sua cadeia de ligação:

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

Padrão do fornecedor: 30 segundos

Cosmos DB

As definições de nível de serviço (não parâmetros de string de ligação) controlam o timeout 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 duração, considere:

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

Tempo limite dos registos agregados do MCP

As operações MCP utilizam tanto o timeout da string de ligação como um timeout adicional específico para o MCP. Aquele que for mais curto dispara primeiro.

Observação

A aggregate-records funcionalidade faz parte do Data API builder 2.0, que está atualmente em pré-visualização.

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