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

> QUOTA 문서

# CREATE QUOTA

사용자 또는 역할에 할당할 수 있는 [쿼터](/ko/concepts/features/security/access-rights#quotas-management)를 생성합니다.

구문:

```sql theme={null}
CREATE QUOTA [IF NOT EXISTS | OR REPLACE] name [ON CLUSTER cluster_name]
    [IN access_storage_type]
    [KEYED BY {user_name | ip_address | forwarded_ip_address | client_key | client_key,user_name | client_key,ip_address | normalized_query_hash} | NOT KEYED]
    [IPV4_PREFIX_BITS number]
    [IPV6_PREFIX_BITS number]
    [FOR [RANDOMIZED] INTERVAL number {second | minute | hour | day | week | month | quarter | year}
        {MAX { {queries | query_selects | query_inserts | errors | result_rows | result_bytes | read_rows | read_bytes | written_bytes | execution_time | failed_sequential_authentications | queries_per_normalized_hash} = number } [,...] |
         NO LIMITS | TRACKING ONLY} [,...]]
    [TO {role [,...] | ALL | ALL EXCEPT role [,...]}]
```

키 `user_name`, `ip_address`, `forwarded_ip_address`, `client_key`, `client_key, user_name`, `client_key, ip_address`, `normalized_query_hash`는 [system.quotas](/ko/reference/system-tables/quotas) 테이블의 필드에 해당합니다.

`IPV4_PREFIX_BITS` 및 `IPV6_PREFIX_BITS` 옵션은 `KEYED BY`가 `ip_address` 또는 `forwarded_ip_address`일 때만 사용할 수 있습니다. 이 옵션은 [system.quotas](/ko/reference/system-tables/quotas) 테이블의 필드에 해당합니다.

매개변수 `queries`, `query_selects`, `query_inserts`, `errors`, `result_rows`, `result_bytes`, `read_rows`, `read_bytes`, `written_bytes`, `execution_time`, `failed_sequential_authentications`, `queries_per_normalized_hash`는 [system.quotas\_usage](/ko/reference/system-tables/quotas_usage) 테이블의 필드에 해당합니다.

`ON CLUSTER` 절을 사용하면 클러스터에 쿼터를 생성할 수 있습니다. 자세한 내용은 [분산 DDL](/ko/reference/statements/distributed-ddl)을 참조하십시오.

**예시**

현재 사용자에 대해 15개월 동안 최대 123개의 쿼리로 제한하는 제약 조건:

```sql theme={null}
CREATE QUOTA qA FOR INTERVAL 15 month MAX queries = 123 TO CURRENT_USER;
```

기본 사용자에 대해 30분 동안 최대 실행 시간을 0.5초로 제한하고, 5쿼터 동안 최대 쿼리 수는 321개로, 최대 오류 수는 10개로 제한하십시오:

```sql theme={null}
CREATE QUOTA qB FOR INTERVAL 30 minute MAX execution_time = 0.5, FOR INTERVAL 5 quarter MAX queries = 321, errors = 10 TO default;
```

고유한 정규화 쿼리 패턴마다 자체 버킷이 할당되고 시간당 실행 횟수가 100회로 제한되도록 QUOTA를 생성합니다:

```sql theme={null}
CREATE QUOTA qC KEYED BY normalized_query_hash FOR INTERVAL 1 hour MAX queries = 100 TO default;
```

정규화된 단일 쿼리 패턴의 실행 횟수는 시간당 최대 50회로 제한합니다(QUOTA 키 유형과 관계없이):

```sql theme={null}
CREATE QUOTA qD FOR INTERVAL 1 hour MAX queries_per_normalized_hash = 50 TO default;
```

xml 구성(ClickHouse Cloud에서는 지원되지 않음)을 사용하는 추가 예시는 [쿼터 가이드](/ko/concepts/features/configuration/server-config/quotas)에서 확인할 수 있습니다.

<div id="related-content">
  ## 관련 콘텐츠
</div>

* 블로그: [ClickHouse로 싱글 페이지 애플리케이션 구축하기](https://clickhouse.com/blog/building-single-page-applications-with-clickhouse-and-http)