HTTP(S) 딕셔너리 소스

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을 구성해야 합니다.

설정 필드:

Setting	Description
`url`	소스 URL입니다.
`format`	파일 포맷입니다. 포맷에 설명된 모든 포맷을 지원합니다.
`credentials`	Basic HTTP authentication입니다. 선택 사항입니다.
`user`	authentication에 필요한 사용자 이름입니다.
`password`	authentication에 필요한 비밀번호입니다.
`headers`	HTTP 요청에 사용되는 모든 사용자 지정 HTTP headers 항목입니다. 선택 사항입니다.
`header`	단일 HTTP header 항목입니다.
`name`	요청을 보낼 때 header에 사용되는 식별자 이름입니다.
`value`	특정 식별자 이름에 설정되는 값입니다.

DDL 명령(CREATE DICTIONARY ...)으로 딕셔너리를 생성할 때는 데이터베이스 사용자가 임의의 HTTP 서버에 접근하지 못하도록, HTTP 딕셔너리의 원격 호스트를 설정의 remote_url_allow_hosts 섹션 내용과 대조하여 확인합니다.