HTTP(S) Dictionary ソース

HTTP(S) サーバーの動作は、Dictionary のメモリ内での格納方法によって異なります。Dictionary が 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 を設定する必要があります。設定フィールド:

設定	説明
`url`	ソース URL。
`format`	ファイルのフォーマット。Formats で説明されているすべてのフォーマットをサポートします。
`credentials`	HTTP Basic 認証。省略可能です。
`user`	認証に必要なユーザー名。
`password`	認証に必要なパスワード。
`headers`	HTTP リクエストで使用するすべてのカスタム HTTP ヘッダーのエントリ。省略可能です。
`header`	単一の HTTP ヘッダーエントリ。
`name`	リクエスト送信時にヘッダーで使用する識別子名。
`value`	特定の識別子名に設定する値。

DDL コマンド (CREATE DICTIONARY ...) を使用して Dictionary を作成する場合、データベースユーザーが任意の HTTP サーバーにアクセスするのを防ぐため、HTTP Dictionary のリモートホストは config の 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リファレンス

データ型

エンジン

関数

フォーマット

設定

システムテーブル

データレイク