http_* 会话设置

这些设置可在 system.settings 中查看，并由 源代码 自动生成。 启用后，HTTP 接口会识别 URL 路径中的 /database/ 组件，并将其用作当前数据库。 这是一个按用户生效的设置，用于控制是否解析已路由的路径式请求。路由本身由服务器级配置设置 http_allow_path_requests 全局控制 (默认关闭) 。必须启用该设置，HTTP 接口才能将路径式请求 (例如 /my_db/my_table.csv) 路由到查询处理程序。由于路由决策在请求完成身份验证之前作出，因此不能依赖按用户生效的设置。http_allow_path_requests 关闭时，未知路径会返回普通的 404。路由后，会根据已通过身份验证用户的有效设置再次检查此设置，因此可针对特定用户、角色或 profile 选择性启用。 启用后，HTTP 接口会识别路径中的 /name=value/ 组件 (Hive 分区风格) ，并将其转换为以 AND 组合的过滤器。还会识别运算符 >、<、>=、<=、!=、<>。 与 http_allow_database_as_path 一样，这是按用户设置；路径式请求的路由由服务器级配置设置 http_allow_path_requests 全局控制 (路由发生在身份验证之前) 。 启用后，任何未被识别为已知参数、设置或以 param_* 为前缀的 URL 参数，都会被视为过滤器，并使用 AND 组合。支持以下两种形式：

• 普通的 name=value 会转换为等值比较 `name` = 'value' (标识符使用反引号，值会作为字符串字面量加引号) 。
• 使用比较运算符 (!=、>、<、>=、<=、<>) 时，会将其视为比较表达式：运算符可以跨参数拆分 (?a!=2、?a>=2) ，也可以在 URL 中没有可用于拆分的 = 时以内联形式编写 (?a<>2、?f(x)>3) ；此时，重新组合的 name[=value] 会被解析为完整的 SQL 表达式。

启用后，HTTP 接口会将 URL 路径的最后一个组件识别为表名，其形式可以是 table、table.format 或 table.format.compression。该路径会被解释为 SELECT * FROM table。 与 http_allow_database_as_path 一样，这是一个按用户生效的设置；路径式请求的路由在全局范围内受服务器级配置设置 http_allow_path_requests 控制 (路由发生在身份验证之前) 。 HTTP 连接超时时间 (以秒为单位) 。 可能的值：

• 任意正整数。
• 0 - 禁用 (超时时间为无限) 。

http_make_head_request 设置允许在通过 HTTP 读取数据时执行 HEAD 请求，以获取待读取文件的信息，例如文件大小。该设置默认启用，因此如果服务器不支持 HEAD 请求，可能需要将其禁用。 启用或禁用在解压来自客户端的 HTTP POST 数据时进行校验和检查。仅适用于 ClickHouse 原生压缩格式 (不用于 gzip 或 deflate) 。 如需了解更多信息，请参阅 HTTP 接口说明。 可能的值：

• 0 — 禁用。
• 1 — 启用。

HTTP 接收超时时间 (秒) 。 可能的取值：

• 任意正整数 (秒) 。0 不是无限超时，且可能导致连接建立失败 (POSIX 套接字超时要求正时间间隔) 。

HTTP 发送超时时间 (以秒为单位) 。 可能的值：

• 任何正整数 (秒) 。0 不是无限超时时间，且可能导致连接建立失败 (POSIX 套接字超时时间要求使用正时间间隔) 。

跳过返回 HTTP_NOT_FOUND 错误的通配符 URL 启用服务器端 HTTP 响应缓冲。 将异常按输出格式写出，以生成有效的输出。适用于 JSON 和 XML 格式。 如果 enable_http_compression = 1，则设置 HTTP 请求响应中的数据压缩级别。 可能的值：1 到 12 的数值。高于 9 的级别需要使用包含 libdeflate 的默认构建版本；不包含 libdeflate 的构建版本支持 1 到 9 级。