HTTP(S) 딕셔너리 소스

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	파일 형식입니다. Formats에 설명된 모든 형식을 지원합니다.
credentials	기본 HTTP 인증입니다. 선택 사항입니다.
user	인증에 필요한 사용자 이름입니다.
password	인증에 필요한 비밀번호입니다.
headers	HTTP 요청에 사용되는 모든 사용자 정의 HTTP 헤더 항목입니다. 선택 사항입니다.
header	단일 HTTP 헤더 항목입니다.
name	요청에 전송할 헤더에 사용되는 식별자 이름입니다.
value	특정 식별자 이름에 대해 설정되는 값입니다.

DDL 명령(CREATE DICTIONARY ...)으로 딕셔너리를 생성할 때, HTTP 딕셔너리용 원격 호스트는 데이터베이스 사용자가 임의의 HTTP 서버에 액세스하지 못하도록 config의 remote_url_allow_hosts 섹션 내용과 비교하여 검증됩니다.