YDBDOCS-740: update query limits (#8704)

2 files changed, 35 insertions, 15 deletions

diff --git a/ydb/docs/en/core/concepts/_includes/limits-ydb.md b/ydb/docs/en/core/concepts/_includes/limits-ydb.md
index e4a174a315e..bb9b8efc4b8 100644
--- a/ydb/docs/en/core/concepts/_includes/limits-ydb.md
+++ b/ydb/docs/en/core/concepts/_includes/limits-ydb.md
@@ -39,15 +39,25 @@ The _Error type_ column shows the status that the query ends with if an error oc
 
 ## Limits on query execution {#query}
 
-The table below lists the limits that apply to query execution. The _Call_ column specifies the public API call that will end with the error status specified in the _Status_ column.
+The table below lists the limits that apply to query execution.
 
-| Parameter | Value | Call | Explanation | Status<br/>in case of<br/>a violation<br/>of the limit |
-| :--- | :--- | :--- | :--- | :---: |
-| Maximum number of rows in query results | 1,000 | ExecuteDataQuery | Complete results of some queries executed using the `ExecuteDataQuery` method may contain more rows than allowed. In this case, a query will return the maximum number of rows allowed, and the result will have the `truncated` flag set. | SUCCESS |
-| Maximum query result size | 50 MB | ExecuteDataQuery | Complete results of some queries may exceed the set limit. In this case, a query will fail returning no data. | PRECONDITION_FAILED |
-| Maximum number of sessions per cluster node | 1,000 | CreateSession | Using the library for working with {{ ydb-short-name }}, an application can create sessions within a connection. Sessions are linked to a node. You can create a limited number of sessions with a single node. | OVERLOADED |
-| Maximum query text length | 10 KB | ExecuteDataQuery | Limit on the length of YQL query text. | BAD_REQUEST |
-| Maximum size of parameter values | 50 MB | ExecuteDataQuery | Limit on the total size of the parameters passed when executing a previously prepared query. | BAD_REQUEST |
+| Parameter | Default | Explanation | Status<br/>in case of<br/>a violation<br/>of the limit |
+| :--- | :--- | :--- | :---: |
+| Query duration | 1800 seconds (30 minutes) | The maximum amount of time allowed for a single query to execute. | TIMEOUT |
+| Maximum number of sessions per cluster node | 1,000 | The limit on the number of sessions that clients can create with each {{ ydb-short-name }} node. | OVERLOADED |
+| Maximum query text length | 10 KB | The maximum allowable length of YQL query text. | BAD_REQUEST |
+| Maximum size of parameter values | 50 MB | The maximum total size of parameters passed when executing a previously prepared query. | BAD_REQUEST |
+
+{% cut "Legacy limits" %}
+
+In previous versions of {{ ydb-short-name }}, queries were typically executed using an API called "Table Service". This API had the following limitations, which have been addressed by replacing it with a new API called "Query Service".
+
+| Parameter | Default | Explanation | Status<br/>in case of<br/>a violation<br/>of the limit |
+| :--- | :--- | :--- | :---: |
+| Maximum number of rows in query results | 1,000 | The complete results of some queries executed using the `ExecuteDataQuery` method may contain more rows than allowed. In such cases, the query will return the maximum number of rows allowed, and the result will have the `truncated` flag set. | SUCCESS |
+| Maximum query result size | 50 MB | The complete results of some queries may exceed the set limit. If this occurs, the query will fail and return no data. | PRECONDITION_FAILED |
+
+{% endcut %}
 
 ## Topic limits {#topic}
 
diff --git a/ydb/docs/ru/core/concepts/_includes/limits-ydb.md b/ydb/docs/ru/core/concepts/_includes/limits-ydb.md
index 52e0cf08c59..acc90021a06 100644
--- a/ydb/docs/ru/core/concepts/_includes/limits-ydb.md
+++ b/ydb/docs/ru/core/concepts/_includes/limits-ydb.md
@@ -39,15 +39,25 @@
 
 ## Ограничения при выполнении запросов {#query}
 
-В таблице ниже перечислены ограничения, действующие при выполнении запросов. В столбце _Вызов_ указан вызов public api, обращение к которому завершится со статусом ошибки, указанным в столбце _Статус_.
+В таблице ниже перечислены ограничения, действующие при выполнении запросов.
 
-| Параметр | Значение | Вызов | Пояснение | Статус<br/>в случае<br/>нарушения<br/>ограничения |
+| Параметр | Значение | Пояснение | Статус<br/>в случае<br/>нарушения<br/>ограничения |
 | :--- | :--- | :--- | :--- | :---: |
-| Максимальное количество строк в результате запроса | 1000 | ExecuteDataQuery | Полные результаты некоторых запросов, выполненных через метод `ExecuteDataQuery`, могут содержать больше строк, чем допустимо. В этом случае в ответ на запрос вернется максимально допустимое число строк, а у результата будет установлен флаг `truncated`. | SUCCESS |
-| Максимальный размер результата запроса  | 50 Мб | ExecuteDataQuery | Полный результат некоторых запросов может превышать установленное ограничение. В этом случае запрос завершится ошибкой, данные не будут возвращены. | PRECONDITION_FAILED |
-| Максимальное количество сессий на ноду кластера  | 1000 | CreateSession | Используя библиотеку для работы с {{ ydb-short-name }}, приложение может создавать сессии в рамках соединения. Сессии привязаны к ноде. С одной нодой можно создать ограниченное количество сессий. | OVERLOADED |
-| Максимальная длина текста запроса | 10 Кб | ExecuteDataQuery | Ограничение на длину текста YQL-запроса. | BAD_REQUEST |
-| Максимальный размер значений параметров | 50 Мб | ExecuteDataQuery | Ограничение на суммарный размер параметров, передаваемых при выполнении ранее подготовленного запроса. | BAD_REQUEST |
+| Длительность запроса | 1800 секунд (30 минут) | Максимальное время на выполнение одного запроса. | TIMEOUT |
+| Максимальное количество сессий на ноду кластера  | 1000 | Ограничение на количество сессий, которые клиент может создать с каждой нодой {{ ydb-short-name }}. | OVERLOADED |
+| Максимальная длина текста запроса | 10 Кб | Ограничение на длину текста YQL-запроса. | BAD_REQUEST |
+| Максимальный размер значений параметров | 50 Мб | Ограничение на суммарный размер параметров, передаваемых при выполнении ранее подготовленного запроса. | BAD_REQUEST |
+
+{% cut "Устаревшие ограничения" %}
+
+В предыдущих версиях {{ ydb-short-name }} запросы выполнялись с помощью API под названием «Table Service». Этот API имел следующие ограничения, которые были устранены при переходе на новый API под названием «Query Service».
+
+| Параметр | Значение | Пояснение | Статус<br/>в случае<br/>нарушения<br/>ограничения |
+| :--- | :--- | :--- | :--- | :---: |
+| Максимальное количество строк в результате запроса | 1000 | Полные результаты некоторых запросов, выполненных через метод `ExecuteDataQuery`, могут содержать больше строк, чем допустимо. В этом случае в ответ на запрос вернется максимально допустимое число строк, а у результата будет установлен флаг `truncated`. | SUCCESS |
+| Максимальный размер результата запроса  | 50 Мб | Полный результат некоторых запросов может превышать установленное ограничение. В этом случае запрос завершится ошибкой, данные не будут возвращены. | PRECONDITION_FAILED |
+
+{% endcut %}
 
 ## Ограничения топиков {#topic}