HTTP(S) 딕셔너리 소스

ClickHouse에서 HTTP 또는 HTTPS 엔드포인트를 딕셔너리 소스로 구성합니다.

HTTP(S) 서버를 사용하는 방식은 딕셔너리가 메모리에 저장되는 방식에 따라 달라집니다. 딕셔너리가 cache 및 complex_key_cache를 사용해 저장된 경우, ClickHouse는 POST 메서드로 요청을 보내 필요한 키를 가져옵니다.

설정 예시:

DDL

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 섹션 내용과 대조하여 확인합니다.