> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> 包含通过 CREATE HANDLER 创建的所有以 SQL 定义的 HTTP 处理程序。

# system.handlers

<div id="description">
  ## 说明
</div>

包含通过 CREATE HANDLER 创建的所有 SQL 定义的 HTTP 处理程序列表。

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

* `name` ([String](/docs/zh/reference/data-types/string)) — 处理程序 的名称。
* `protocol` ([Nullable(String)](/docs/zh/reference/data-types/nullable)) — 处理程序 限定使用的可组合协议；如果 处理程序 在所有 HTTP 端点 (内置 `http`/`https` 端口以及所有 HTTP 类型的可组合协议 listener) 上均处于活动状态，则为 NULL。
* `url_match_type` ([String](/docs/zh/reference/data-types/string)) — URL 匹配方式：精确匹配、前缀匹配或正则表达式匹配。
* `url` ([String](/docs/zh/reference/data-types/string)) — 处理程序 要匹配的 URL 模式。
* `methods` ([Array(String)](/docs/zh/reference/data-types/array)) — 允许的 HTTP 方法。
* `type` ([String](/docs/zh/reference/data-types/string)) — 处理程序 类型 (仅支持 `query`) 。
* `query` ([String](/docs/zh/reference/data-types/string)) — 处理程序 执行的 SQL 查询。除非用户有权查看，否则会隐藏 secrets。
* `create_query` ([String](/docs/zh/reference/data-types/string)) — CREATE HANDLER 语句。除非用户有权查看，否则会隐藏 secrets。