From 64fd2304a9770098eb62f8da15a8826aea5e66c2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?I=C3=B1igo=20Medina?= Date: Fri, 13 Apr 2018 00:01:32 +0200 Subject: [PATCH] Create 05-timeout-limiting.md --- docs/support/05-timeout-limiting.md | 32 +++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 docs/support/05-timeout-limiting.md diff --git a/docs/support/05-timeout-limiting.md b/docs/support/05-timeout-limiting.md new file mode 100644 index 00000000..e12e6d8f --- /dev/null +++ b/docs/support/05-timeout-limiting.md @@ -0,0 +1,32 @@ +## Timeout limit + +Our APIs work following a request <-> response model. While CARTO is busy getting that action done or retrieving that information, part of our infrastructure is devoted to that process and is therefore unavailable for any other user. Typically this is not a problem, as most requests get serviced quickly enough. However, certain requests can take a long time to process, either by design (e.g., updating a huge table) or by mistake. To prevent this long-running queries from effectively blocking the usage of our platform resources, CARTO will discard requests that cannot be fulfilled in less than a certain amount of time. + +Maps API is affected by this kind of limiting. + +### Per User + +Timeout limit is on a per-user basis (or more accurately described, per user access). + +### How it works + +Every query has a statement timeout. When a request reaches that value, the response returns an error. + +### Response Codes + +When query exceeds the timeout limit, the API will return an HTTP `429 Too Many Requests` error. + +### Tips + +You are able to avoid common issues that trigger timeout limits following these actions: + +- Always use database indexes +- Try to use batch API to insert/update/delete data + +### Timeout Limits Chart + +Below, you can find the values of the timeout limit by user account type. + +|Enterprise plans |Professional plans |Free plans | +| --- | --- | --- | +| 25 seconds | 15 seconds | 5 seconds |