Origem de dicionário HTTP(S)

O funcionamento com um servidor HTTP(S) depende de como o dicionário é armazenado na memória. Se o dicionário for armazenado usando cache e complex_key_cache, o ClickHouse solicita as chaves necessárias enviando uma requisição pelo método POST. Exemplo de configurações:

DDL
Arquivo de configuração

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>

Para que o ClickHouse possa acessar um recurso HTTPS, você deve configurar o openSSL na configuração do servidor. Campos de configuração:

Configuração	Descrição
`url`	A URL da origem.
`format`	O formato do arquivo. Todos os formatos descritos em Formats são compatíveis.
`credentials`	Autenticação HTTP Basic. Opcional.
`user`	Nome de usuário necessário para a autenticação.
`password`	Senha necessária para a autenticação.
`headers`	Todas as entradas de cabeçalhos HTTP personalizados usadas na requisição HTTP. Opcional.
`header`	Uma única entrada de cabeçalho HTTP.
`name`	Nome do identificador usado para o cabeçalho enviado na requisição.
`value`	Valor definido para um nome de identificador específico.

Ao criar um dicionário usando o comando DDL (CREATE DICTIONARY ...), os hosts remotos de dicionários HTTP são verificados em relação ao conteúdo da seção remote_url_allow_hosts da configuração para impedir que usuários do banco de dados acessem servidores HTTP arbitrários. Assim como a senha, os cabeçalhos, incluindo seus nomes, são exibidos como HEADERS ('[HIDDEN]') na saída de SHOW CREATE DICTIONARY, em system.tables e nos logs de consultas. Também como ocorre com a senha, uma consulta que não pode ser analisada é registrada tal como está, com a aplicação apenas de query_masking_rules. Para exibir os cabeçalhos em SHOW CREATE DICTIONARY e system.tables, habilite a configuração de servidor display_secrets_in_show_and_select e a configuração de formato format_display_secrets_in_show_and_select; além disso, o usuário precisa ter o privilégio displaySecretsInShowAndSelect. Essas configurações não afetam os logs de consultas.

Referência de SQL

Tipos de dados

Motores

Funções

Formatos

Configurações

Tabelas de sistema

Lagos de dados