HTTP(S) dictionary source

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 섹션 내용과 대조하여 확인합니다. 헤더는 이름까지 포함하여 비밀번호와 동일하게 SHOW CREATE DICTIONARY 출력, system.tables, 쿼리 로그에서 HEADERS ('[HIDDEN]')로 표시됩니다. 비밀번호와 마찬가지로 파싱할 수 없는 쿼리는 query_masking_rules만 적용된 상태로 그대로 기록됩니다. SHOW CREATE DICTIONARY 및 system.tables에서 헤더를 표시하려면 서버 설정 display_secrets_in_show_and_select와 포맷 설정 format_display_secrets_in_show_and_select를 활성화하십시오. 또한 사용자에게 displaySecretsInShowAndSelect 권한이 있어야 합니다. 이 설정들은 쿼리 로그에는 영향을 주지 않습니다.

SQL 참고

데이터 타입

엔진

함수

포맷

설정

시스템 테이블

데이터 레이크