ClickHouse/docs/en/operations/system-tables/quota_usage.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

36 lines
4.5 KiB
Markdown
Raw Normal View History

2022-08-28 13:53:52 +00:00
---
2022-08-28 13:58:27 +00:00
slug: /en/operations/system-tables/quota_usage
2022-08-28 13:53:52 +00:00
---
2022-06-02 10:55:18 +00:00
# quota_usage
DOCS-664: system.quotas (#12472) * DOCSUP-1362[CLICKHOUSEDOCS] [ClickHouse] Describe system tables for RBAC (#127) * Describe system tables for RBAC: quotas, quota_limits, quota_usage, quotas_usage. * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update system-tables.md * Update system-tables.md * Update system-tables.md * Add desc system.quota_limits, system.quotas_usage * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update system-tables.md Сorrect description of max_read_rows. * Update system-tables.md Updated the description of randomized intervals. * Update system-tables.md Updated description of key_type. * Update system-tables.md Updated description of 'roles' * Update system-tables.md Update * Actualized the description. * translation Co-authored-by: Anna Devyatova <annadevyatova@yandex-team.ru> Co-authored-by: BayoNet <da-daos@yandex.ru> * CLICKHOUSEDOCS-664: Splitted the description into separated files. Co-authored-by: Sergei Shtykov <bayonet@yandex-team.ru> Co-authored-by: Anna <42538400+adevyatova@users.noreply.github.com> Co-authored-by: Anna Devyatova <annadevyatova@yandex-team.ru>
2020-07-14 06:57:39 +00:00
Quota usage by the current user: how much is used and how much is left.
DOCS-664: system.quotas (#12472) * DOCSUP-1362[CLICKHOUSEDOCS] [ClickHouse] Describe system tables for RBAC (#127) * Describe system tables for RBAC: quotas, quota_limits, quota_usage, quotas_usage. * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update system-tables.md * Update system-tables.md * Update system-tables.md * Add desc system.quota_limits, system.quotas_usage * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/system-tables.md Co-authored-by: BayoNet <da-daos@yandex.ru> * Update system-tables.md Сorrect description of max_read_rows. * Update system-tables.md Updated the description of randomized intervals. * Update system-tables.md Updated description of key_type. * Update system-tables.md Updated description of 'roles' * Update system-tables.md Update * Actualized the description. * translation Co-authored-by: Anna Devyatova <annadevyatova@yandex-team.ru> Co-authored-by: BayoNet <da-daos@yandex.ru> * CLICKHOUSEDOCS-664: Splitted the description into separated files. Co-authored-by: Sergei Shtykov <bayonet@yandex-team.ru> Co-authored-by: Anna <42538400+adevyatova@users.noreply.github.com> Co-authored-by: Anna Devyatova <annadevyatova@yandex-team.ru>
2020-07-14 06:57:39 +00:00
Columns:
- `quota_name` ([String](../../sql-reference/data-types/string.md)) — Quota name.
- `quota_key`([String](../../sql-reference/data-types/string.md)) — Key value. For example, if keys = \[`ip address`\], `quota_key` may have a value 192.168.1.1.
- `start_time`([Nullable](../../sql-reference/data-types/nullable.md)([DateTime](../../sql-reference/data-types/datetime.md))) — Start time for calculating resource consumption.
- `end_time`([Nullable](../../sql-reference/data-types/nullable.md)([DateTime](../../sql-reference/data-types/datetime.md))) — End time for calculating resource consumption.
- `duration` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Length of the time interval for calculating resource consumption, in seconds.
- `queries` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — The total number of requests on this interval.
- `query_selects` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — The total number of select requests on this interval.
- `query_inserts` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — The total number of insert requests on this interval.
- `max_queries` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Maximum number of requests.
- `errors` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — The number of queries that threw an exception.
- `max_errors` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Maximum number of errors.
- `result_rows` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — The total number of rows given as a result.
- `max_result_rows` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Maximum number of result rows.
- `result_bytes` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — RAM volume in bytes used to store a queries result.
- `max_result_bytes` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Maximum RAM volume used to store a queries result, in bytes.
- `read_rows` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — The total number of source rows read from tables for running the query on all remote servers.
- `max_read_rows` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Maximum number of rows read from all tables and table functions participated in queries.
- `read_bytes` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — The total number of bytes read from all tables and table functions participated in queries.
- `max_read_bytes` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Maximum of bytes read from all tables and table functions.
- `failed_sequential_authentications` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/float.md))) — The total count of sequential authentication failures. If the user entered the correct password before exceed `failed_sequential_authentications` threshold then the counter will be reset.
- `max_failed_sequential_authentications` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/float.md))) — Maximum count of sequential authentication failures.
- `execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — The total query execution time, in seconds (wall time).
- `max_execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — Maximum of query execution time.
## See Also {#see-also}
- [SHOW QUOTA](../../sql-reference/statements/show.md#show-quota-statement)