> ## 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.

> 현재 사용자의 QUOTA 사용 현황(얼마나 사용했고 얼마나 남았는지 등)에 관한 정보를 담고 있는 system table입니다.

# system.quota_usage

<Info>
  **ClickHouse Cloud에서 쿼리하기**

  이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 `clusterAllReplicas` 함수를 사용해야 합니다. 자세한 내용은 [여기](/ko/reference/system-tables/overview#system-tables-in-clickhouse-cloud)를 참조하십시오.
</Info>

<div id="description">
  ## 설명
</div>

현재 사용자의 QUOTA 사용량: 사용된 양과 남은 양입니다.

<div id="columns">
  ## 컬럼
</div>

* `quota_name` ([String](/ko/reference/data-types)) — QUOTA 이름입니다.
* `quota_key` ([String](/ko/reference/data-types)) — 키 값입니다.
* `start_time` ([Nullable(DateTime)](/ko/reference/data-types)) — 리소스 활용을 계산하기 위한 시작 시간입니다.
* `end_time` ([Nullable(DateTime)](/ko/reference/data-types)) — 리소스 활용을 계산하기 위한 종료 시간입니다.
* `duration` ([Nullable(UInt32)](/ko/reference/data-types)) — 리소스 활용을 계산하기 위한 시간 인터벌의 길이(초)입니다.
* `queries` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 실행된 쿼리 수입니다.
* `max_queries` ([Nullable(UInt64)](/ko/reference/data-types)) — 실행이 허용된 모든 유형의 쿼리에 대한 최대 개수입니다.
* `query_selects` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 실행된 SELECT 쿼리 수입니다.
* `max_query_selects` ([Nullable(UInt64)](/ko/reference/data-types)) — 실행이 허용된 SELECT 쿼리의 최대 개수입니다.
* `query_inserts` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 실행된 INSERT 쿼리 수입니다.
* `max_query_inserts` ([Nullable(UInt64)](/ko/reference/data-types)) — 실행이 허용된 INSERT 쿼리의 최대 개수입니다.
* `errors` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 오류가 발생한 쿼리 수입니다.
* `max_errors` ([Nullable(UInt64)](/ko/reference/data-types)) — 지정된 기간 내 오류가 발생할 수 있는 쿼리의 최대 개수입니다.
* `result_rows` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 기간 내 모든 쿼리의 결과 집합(result set)에 포함된 전체 행 수입니다.
* `max_result_rows` ([Nullable(UInt64)](/ko/reference/data-types)) — 지정된 기간 내 허용되는 모든 쿼리의 결과 집합 전체 행 수의 최대값입니다.
* `result_bytes` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 기간 내 모든 쿼리의 결과 집합에 포함된 전체 바이트 수입니다.
* `max_result_bytes` ([Nullable(UInt64)](/ko/reference/data-types)) — 지정된 기간 내 허용되는 모든 쿼리의 결과 집합 전체 바이트 수의 최대값입니다.
* `read_rows` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 기간 내 모든 쿼리 실행 중 읽은 전체 행 수입니다.
* `max_read_rows` ([Nullable(UInt64)](/ko/reference/data-types)) — 지정된 기간 내 허용되는 모든 쿼리 실행 중 읽을 수 있는 최대 행 수입니다.
* `read_bytes` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 기간 내 모든 쿼리 실행 중 읽은 전체 바이트 수입니다.
* `max_read_bytes` ([Nullable(UInt64)](/ko/reference/data-types)) — 지정된 기간 내 허용되는 모든 쿼리 실행 중 읽을 수 있는 최대 바이트 수입니다.
* `execution_time` ([Nullable(Float64)](/ko/reference/data-types)) — 현재 기간 내 쿼리 실행에 소요된 전체 시간(나노초)입니다.
* `max_execution_time` ([Nullable(Float64)](/ko/reference/data-types)) — 지정된 기간 내 모든 쿼리 실행에 허용되는 최대 시간(나노초)입니다.
* `written_bytes` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 기간 내 모든 쿼리 실행 중 기록된 전체 바이트 수입니다.
* `max_written_bytes` ([Nullable(UInt64)](/ko/reference/data-types)) — 지정된 기간 내 허용되는 모든 쿼리 실행 중 기록할 수 있는 최대 바이트 수입니다.
* `failed_sequential_authentications` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 기간 내 연속된 인증 실패 횟수입니다.
* `max_failed_sequential_authentications` ([Nullable(UInt64)](/ko/reference/data-types)) — 지정된 기간 내 허용되는 연속 인증 실패의 최대 횟수입니다.
* `queries_per_normalized_hash` ([Nullable(UInt64)](/ko/reference/data-types)) — 현재 기간 내 단일 정규화된 쿼리의 최대 실행 횟수입니다.
* `max_queries_per_normalized_hash` ([Nullable(UInt64)](/ko/reference/data-types)) — 지정된 기간 내 허용되는 단일 정규화된 쿼리의 최대 실행 횟수입니다.

<div id="see-also">
  ## 관련 항목
</div>

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