HTTP(S) 字典源 | ClickHouse Docs

如何与 HTTP(S) 服务器交互，取决于字典在内存中的存储方式。如果字典使用 cache 和 complex_key_cache 存储，ClickHouse 会通过 POST 方法发送请求来获取所需的键。

设置示例：

SOURCE(HTTP(
    url 'http://[::1]/os.tsv'
    format 'TabSeparated'
    credentials(user 'user' password 'password')
    headers(header(name 'API-KEY' value 'key'))
))

<source>
    <http>
        <url>http://[::1]/os.tsv</url>
        <format>TabSeparated</format>
        <credentials>
            <user>user</user>
            <password>password</password>
        </credentials>
        <headers>
            <header>
                <name>API-KEY</name>
                <value>key</value>
            </header>
        </headers>
    </http>
</source>

要让 ClickHouse 能够访问 HTTPS 资源，必须在服务器配置中配置 OpenSSL。

设置字段：

设置	说明
`url`	源 URL。
`format`	文件格式。支持 Formats 中描述的所有格式。
`credentials`	基本 HTTP 身份验证。可选。
`user`	身份验证所需的用户名。
`password`	身份验证所需的密码。
`headers`	HTTP 请求中使用的所有自定义 HTTP 请求头条目。可选。
`header`	单个 HTTP 请求头条目。
`name`	请求中发送的请求头名称。
`value`	为特定名称设置的值。

使用 DDL 命令 (CREATE DICTIONARY ...) 创建字典时，会根据配置中 remote_url_allow_hosts 部分的内容检查 HTTP 字典的远程主机，以防止数据库用户访问任意 HTTP 服务器。