mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-02 12:32:04 +00:00
67c2e50331
* update presentations * CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com * update submodule * lost files * CLICKHOUSE-2981: prefer sphinx docs over original reference * CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links * update presentations * Less confusing directory structure (docs -> doc/reference/) * Minify sphinx docs too * Website release script: fail fast + pass docker hash on deploy * Do not underline links in docs * shorter * cleanup docker images * tune nginx config * CLICKHOUSE-3043: get rid of habrastorage links * Lost translation * CLICKHOUSE-2936: temporary client-side redirect * behaves weird in test * put redirect back * CLICKHOUSE-3047: copy docs txts to public too * move to proper file * remove old pages to avoid confusion * Remove reference redirect warning for now * Refresh README.md * Yellow buttons in docs * Use svg flags instead of unicode ones in docs * fix test website instance * Put flags to separate files * wrong flag * Copy Yandex.Metrica introduction from main page to docs * Yet another home page structure change, couple new blocks (CLICKHOUSE-3045) * Update Contacts section * CLICKHOUSE-2849: more detailed legal information * CLICKHOUSE-2978 preparation - split by files * More changes in Contacts block * Tune texts on index page * update presentations * One more benchmark * Add usage sections to index page, adapted from slides * Get the roadmap started, based on slides from last ClickHouse Meetup * CLICKHOUSE-2977: some rendering tuning * Get rid of excessive section in the end of getting started * Make headers linkable * CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849 * CLICKHOUSE-2981: fix mobile styles in docs * Ban crawling of duplicating docs * Open some external links in new tab * Ban old docs too * Lots of trivial fixes in english docs * Lots of trivial fixes in russian docs * Remove getting started copies in markdown * Add Yandex.Webmaster * Fix some sphinx warnings * More warnings fixed in english docs * More sphinx warnings fixed * Add code-block:: text * More code-block:: text * These headers look not that well * Better switch between documentation languages * merge use_case.rst into ya_metrika_task.rst * Edit the agg_functions.rst texts * Add lost empty lines * Lost blank lines * Add new logo sizes * update presentations * Next step in migrating to new documentation * Fix all warnings in en reference * Fix all warnings in ru reference * Re-arrange existing reference * Move operation tips to main reference * Fix typos noticed by milovidov@ * Get rid of zookeeper.md * Looks like duplicate of tutorial.html * Fix some mess with html tags in tutorial * No idea why nobody noticed this before, but it was completely not clear whet to get the data * Match code block styling between main and tutorial pages (in favor of the latter) * Get rid of some copypaste in tutorial * Normalize header styles * Move example_datasets to sphinx * Move presentations submodule to website * Move and update README.md * No point in duplicating articles from habrahabr here * Move development-related docs as is for now * doc/reference/ -> docs/ (to match the URL on website) * Adapt links to match the previous commit * Adapt development docs to rst (still lacks translation and strikethrough support) * clean on release * blacklist presentations in gulp * strikethrough support in sphinx * just copy development folder for now * fix weird introduction in style article * Style guide translation (WIP) * Finish style guide translation to English * gulp clean separately * Update year in LICENSE * Initial CONTRIBUTING.md * Fix remaining links to old docs in tutorial * Some tutorial fixes * Typo * Another typo * Update list of authors from yandex-team accoding to git log
104 lines
7.0 KiB
ReStructuredText
104 lines
7.0 KiB
ReStructuredText
Квоты
|
||
=====
|
||
|
||
Квоты позволяют ограничить использование ресурсов за некоторый интервал времени, или просто подсчитывать использование ресурсов.
|
||
Квоты настраиваются в конфиге пользователей. Обычно это users.xml.
|
||
|
||
В системе есть возможность ограничить сложность одного запроса. Для этого смотрите раздел "Ограничения на сложность запроса".
|
||
|
||
В отличие от них, квоты:
|
||
* ограничивают не один запрос, а множество запросов, которые могут быть выполнены за интервал времени;
|
||
* при распределённой обработке запроса, учитывают ресурсы, потраченные на всех удалённых серверах.
|
||
|
||
Рассмотрим фрагмент файла users.xml, описывающего квоты.
|
||
|
||
.. code-block:: xml
|
||
|
||
<!-- Квоты. -->
|
||
<quotas>
|
||
<!-- Имя квоты. -->
|
||
<default>
|
||
<!-- Ограничения за интервал времени. Можно задать много интервалов с разными ограничениями. -->
|
||
<interval>
|
||
<!-- Длина интервала. -->
|
||
<duration>3600</duration>
|
||
|
||
<!-- Без ограничений. Просто считать соответствующие данные за указанный интервал. -->
|
||
<queries>0</queries>
|
||
<errors>0</errors>
|
||
<result_rows>0</result_rows>
|
||
<read_rows>0</read_rows>
|
||
<execution_time>0</execution_time>
|
||
</interval>
|
||
</default>
|
||
|
||
Видно, что квота по умолчанию просто считает использование ресурсов за каждый час, но не ограничивает их.
|
||
Подсчитанное использование ресурсов за каждый интервал, выводится в лог сервера после каждого запроса.
|
||
|
||
.. code-block:: xml
|
||
|
||
<statbox>
|
||
<!-- Ограничения за интервал времени. Можно задать много интервалов с разными ограничениями. -->
|
||
<interval>
|
||
<!-- Длина интервала. -->
|
||
<duration>3600</duration>
|
||
|
||
<queries>1000</queries>
|
||
<errors>100</errors>
|
||
<result_rows>1000000000</result_rows>
|
||
<read_rows>100000000000</read_rows>
|
||
<execution_time>900</execution_time>
|
||
</interval>
|
||
|
||
<interval>
|
||
<duration>86400</duration>
|
||
|
||
<queries>10000</queries>
|
||
<errors>1000</errors>
|
||
<result_rows>5000000000</result_rows>
|
||
<read_rows>500000000000</read_rows>
|
||
<execution_time>7200</execution_time>
|
||
</interval>
|
||
</statbox>
|
||
|
||
Для квоты с именем statbox заданы ограничения за каждый час и за каждые 24 часа (86 400 секунд). Интервал времени считается начиная от некоторого implementation defined фиксированного момента времени. То есть, интервал длины 24 часа начинается не обязательно в полночь.
|
||
|
||
Когда интервал заканчивается, все накопленные значения сбрасываются. То есть, в следующий час, расчёт квоты за час, начинается заново.
|
||
|
||
Рассмотрим величины, которые можно ограничить:
|
||
|
||
``queries`` - общее количество запросов;
|
||
|
||
``errors`` - количество запросов, при выполнении которых было выкинуто исключение;
|
||
|
||
``result_rows`` - суммарное количество строк, отданных в виде результата;
|
||
|
||
``read_rows`` - суммарное количество исходных строк, прочитанных из таблиц, для выполнения запроса, на всех удалённых серверах;
|
||
|
||
``execution_time`` - суммарное время выполнения запросов, в секундах (wall time);
|
||
|
||
Если за хотя бы один интервал, ограничение превышено, то кидается исключение с текстом о том, какая величина превышена, за какой интервал, и когда начнётся новый интервал (когда снова можно будет задавать запросы).
|
||
|
||
Для квоты может быть включена возможность указывать "ключ квоты", чтобы производить учёт ресурсов для многих ключей независимо. Рассмотрим это на примере:
|
||
|
||
.. code-block:: xml
|
||
|
||
<!-- Для глобального конструктора отчётов. -->
|
||
<web_global>
|
||
<!-- keyed - значит в параметре запроса передаётся "ключ" quota_key,
|
||
и квота считается по отдельности для каждого значения ключа.
|
||
Например, в качестве ключа может передаваться логин пользователя в Метрике,
|
||
и тогда квота будет считаться для каждого логина по отдельности.
|
||
Имеет смысл использовать только если quota_key передаётся не пользователем, а программой.
|
||
|
||
Также можно написать <keyed_by_ip /> - тогда в качестве ключа квоты используется IP-адрес.
|
||
(но стоит учесть, что пользователь может достаточно легко менять IPv6-адрес)
|
||
-->
|
||
<keyed />
|
||
|
||
Квота прописывается для пользователей в секции users конфига. Смотрите раздел "Права доступа".
|
||
|
||
При распределённой обработке запроса, накопленные величины хранятся на сервере-инициаторе запроса. То есть, если пользователь пойдёт на другой сервер - там квота будет действовать "с нуля".
|
||
|
||
При перезапуске сервера, квоты сбрасываются.
|