> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 包含当前用户配额使用情况信息的系统表， 例如配额已使用多少以及还剩多少。

# system.quota_usage

<Info>
  **在 ClickHouse Cloud 中查询**

  此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 `clusterAllReplicas` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
</Info>

<div id="description">
  ## 描述
</div>

当前用户的配额使用情况：已使用量和剩余量。

<div id="columns">
  ## 列
</div>

* `quota_name` ([String](/zh/reference/data-types)) — 配额名称。
* `quota_key` ([String](/zh/reference/data-types)) — 键值。
* `start_time` ([Nullable(DateTime)](/zh/reference/data-types)) — 用于计算资源消耗的开始时间。
* `end_time` ([Nullable(DateTime)](/zh/reference/data-types)) — 用于计算资源消耗的结束时间。
* `duration` ([Nullable(UInt32)](/zh/reference/data-types)) — 用于计算资源消耗的时间间隔长度，单位为秒。
* `queries` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前已执行的查询数。
* `max_queries` ([Nullable(UInt64)](/zh/reference/data-types)) — 允许执行的各类查询的最大数量。
* `query_selects` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前已执行的 SELECT 查询数。
* `max_query_selects` ([Nullable(UInt64)](/zh/reference/data-types)) — 允许执行的 SELECT 查询最大数量。
* `query_inserts` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前已执行的 INSERT 查询数。
* `max_query_inserts` ([Nullable(UInt64)](/zh/reference/data-types)) — 允许执行的 INSERT 查询最大数量。
* `errors` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前发生错误的查询数。
* `max_errors` ([Nullable(UInt64)](/zh/reference/data-types)) — 在指定时间段内允许发生错误的查询最大数量。
* `result_rows` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前时间段内，所有查询结果集中的总行数。
* `max_result_rows` ([Nullable(UInt64)](/zh/reference/data-types)) — 在指定时间段内，所有查询结果集中允许的最大总行数。
* `result_bytes` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前时间段内，所有查询结果集中的总字节数。
* `max_result_bytes` ([Nullable(UInt64)](/zh/reference/data-types)) — 在指定时间段内，所有查询结果集中允许的最大总字节数。
* `read_rows` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前时间段内，执行所有查询期间读取的总行数。
* `max_read_rows` ([Nullable(UInt64)](/zh/reference/data-types)) — 在指定时间段内，执行所有查询期间允许读取的最大行数。
* `read_bytes` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前时间段内，执行所有查询期间读取的总字节数。
* `max_read_bytes` ([Nullable(UInt64)](/zh/reference/data-types)) — 在指定时间段内，执行所有查询期间允许读取的最大字节数。
* `execution_time` ([Nullable(Float64)](/zh/reference/data-types)) — 当前时间段内，执行查询所花费的总时间 (以纳秒为单位) 。
* `max_execution_time` ([Nullable(Float64)](/zh/reference/data-types)) — 在指定时间段内，允许所有查询执行的最大总时间 (以纳秒为单位) 。
* `written_bytes` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前时间段内，执行所有查询期间写入的总字节数。
* `max_written_bytes` ([Nullable(UInt64)](/zh/reference/data-types)) — 在指定时间段内，执行所有查询期间允许写入的最大字节数。
* `failed_sequential_authentications` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前时间段内，连续身份验证失败的次数。
* `max_failed_sequential_authentications` ([Nullable(UInt64)](/zh/reference/data-types)) — 在指定时间段内，允许的最大连续身份验证失败次数。
* `queries_per_normalized_hash` ([Nullable(UInt64)](/zh/reference/data-types)) — 当前时间段内，任一单个归一化查询的当前最大执行次数。
* `max_queries_per_normalized_hash` ([Nullable(UInt64)](/zh/reference/data-types)) — 在指定时间段内，任一单个归一化查询允许的最大执行次数。

<div id="see-also">
  ## 另请参阅
</div>

* [SHOW QUOTA](/zh/reference/statements/show#show-quota))
