Skip to content

Commit 5ef326b

Browse files
authored
YDBDOCS-740: update query limits (#8704)
1 parent 0ba24ba commit 5ef326b

File tree

2 files changed

+36
-16
lines changed

2 files changed

+36
-16
lines changed

ydb/docs/en/core/concepts/_includes/limits-ydb.md

Lines changed: 19 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -39,15 +39,25 @@ The _Error type_ column shows the status that the query ends with if an error oc
3939

4040
## Limits on query execution {#query}
4141

42-
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.
43-
44-
| Parameter | Value | Call | Explanation | Status<br/>in case of<br/>a violation<br/>of the limit |
45-
| :--- | :--- | :--- | :--- | :---: |
46-
| 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 |
47-
| 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 |
48-
| 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 |
49-
| Maximum query text length | 10 KB | ExecuteDataQuery | Limit on the length of YQL query text. | BAD_REQUEST |
50-
| 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 |
42+
The table below lists the limits that apply to query execution.
43+
44+
| Parameter | Default | Explanation | Status<br/>in case of<br/>a violation<br/>of the limit |
45+
| :--- | :--- | :--- | :---: |
46+
| Query duration | 1800 seconds (30 minutes) | The maximum amount of time allowed for a single query to execute. | TIMEOUT |
47+
| 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 |
48+
| Maximum query text length | 10 KB | The maximum allowable length of YQL query text. | BAD_REQUEST |
49+
| Maximum size of parameter values | 50 MB | The maximum total size of parameters passed when executing a previously prepared query. | BAD_REQUEST |
50+
51+
{% cut "Legacy limits" %}
52+
53+
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".
54+
55+
| Parameter | Default | Explanation | Status<br/>in case of<br/>a violation<br/>of the limit |
56+
| :--- | :--- | :--- | :---: |
57+
| 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 |
58+
| 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 |
59+
60+
{% endcut %}
5161

5262
## Topic limits {#topic}
5363

ydb/docs/ru/core/concepts/_includes/limits-ydb.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -39,15 +39,25 @@
3939

4040
## Ограничения при выполнении запросов {#query}
4141

42-
В таблице ниже перечислены ограничения, действующие при выполнении запросов. В столбце _Вызов_ указан вызов public api, обращение к которому завершится со статусом ошибки, указанным в столбце _Статус_.
42+
В таблице ниже перечислены ограничения, действующие при выполнении запросов.
4343

44-
| Параметр | Значение | Вызов | Пояснение | Статус<br/>в случае<br/>нарушения<br/>ограничения |
44+
| Параметр | Значение | Пояснение | Статус<br/>в случае<br/>нарушения<br/>ограничения |
4545
| :--- | :--- | :--- | :--- | :---: |
46-
| Максимальное количество строк в результате запроса | 1000 | ExecuteDataQuery | Полные результаты некоторых запросов, выполненных через метод `ExecuteDataQuery`, могут содержать больше строк, чем допустимо. В этом случае в ответ на запрос вернется максимально допустимое число строк, а у результата будет установлен флаг `truncated`. | SUCCESS |
47-
| Максимальный размер результата запроса | 50 Мб | ExecuteDataQuery | Полный результат некоторых запросов может превышать установленное ограничение. В этом случае запрос завершится ошибкой, данные не будут возвращены. | PRECONDITION_FAILED |
48-
| Максимальное количество сессий на ноду кластера | 1000 | CreateSession | Используя библиотеку для работы с {{ ydb-short-name }}, приложение может создавать сессии в рамках соединения. Сессии привязаны к ноде. С одной нодой можно создать ограниченное количество сессий. | OVERLOADED |
49-
| Максимальная длина текста запроса | 10 Кб | ExecuteDataQuery | Ограничение на длину текста YQL-запроса. | BAD_REQUEST |
50-
| Максимальный размер значений параметров | 50 Мб | ExecuteDataQuery | Ограничение на суммарный размер параметров, передаваемых при выполнении ранее подготовленного запроса. | BAD_REQUEST |
46+
| Длительность запроса | 1800 секунд (30 минут) | Максимальное время на выполнение одного запроса. | TIMEOUT |
47+
| Максимальное количество сессий на ноду кластера | 1000 | Ограничение на количество сессий, которые клиент может создать с каждой нодой {{ ydb-short-name }}. | OVERLOADED |
48+
| Максимальная длина текста запроса | 10 Кб | Ограничение на длину текста YQL-запроса. | BAD_REQUEST |
49+
| Максимальный размер значений параметров | 50 Мб | Ограничение на суммарный размер параметров, передаваемых при выполнении ранее подготовленного запроса. | BAD_REQUEST |
50+
51+
{% cut "Устаревшие ограничения" %}
52+
53+
В предыдущих версиях {{ ydb-short-name }} запросы выполнялись с помощью API под названием «Table Service». Этот API имел следующие ограничения, которые были устранены при переходе на новый API под названием «Query Service».
54+
55+
| Параметр | Значение | Пояснение | Статус<br/>в случае<br/>нарушения<br/>ограничения |
56+
| :--- | :--- | :--- | :--- | :---: |
57+
| Максимальное количество строк в результате запроса | 1000 | Полные результаты некоторых запросов, выполненных через метод `ExecuteDataQuery`, могут содержать больше строк, чем допустимо. В этом случае в ответ на запрос вернется максимально допустимое число строк, а у результата будет установлен флаг `truncated`. | SUCCESS |
58+
| Максимальный размер результата запроса | 50 Мб | Полный результат некоторых запросов может превышать установленное ограничение. В этом случае запрос завершится ошибкой, данные не будут возвращены. | PRECONDITION_FAILED |
59+
60+
{% endcut %}
5161

5262
## Ограничения топиков {#topic}
5363

0 commit comments

Comments
 (0)