Skip to main content
これらの設定は system.settings で利用でき、ソースコード から自動生成されています。

http_allow_database_as_path

有効にすると、HTTPインターフェイスはURLパス内の/database/部分を認識し、これを現在のデータベースとして使用します。 これは、ルーティングされたパス形式のリクエストを解釈するかどうかを制御するユーザーごとの設定です。ルーティング自体は、サーバーレベルの設定http_allow_path_requests (デフォルトでは無効) によってグローバルに制御されます。HTTPインターフェイスがパス形式のリクエスト (/my_db/my_table.csvなど) をクエリハンドラーにルーティングするには、この設定を有効にする必要があります。ルーティングの判定はリクエストの認証前に行われるため、ユーザーごとの設定に依存させることはできません。http_allow_path_requestsが無効の場合、未知のパスには通常の404が返されます。ルーティング後、この設定は認証済みユーザーに有効な設定に照らして再度確認されるため、ユーザー、ロール、またはプロファイルごとに選択的に有効化できます。

http_allow_filters_as_path

有効にすると、HTTP インターフェイスはパス内の /name=value/ 部分 (Hive パーティション化スタイル) を認識し、AND で結合したフィルターに変換します。演算子 ><>=<=!=<> も認識されます。 http_allow_database_as_path と同様に、これはユーザーごとの設定です。パス形式のリクエストのルーティングは、サーバーレベルの http_allow_path_requests 設定によってグローバルに制御されます (ルーティングは認証前に行われます) 。

http_allow_filters_as_unrecognized_url_parameters

有効にすると、既知のパラメータ、設定、param_* プレフィックスのいずれにも該当しない URL パラメータはすべてフィルターとして扱われ、AND で結合されます。次の 2 つの形式を使用できます。
  • 単純な name=value は、等価比較 `name` = 'value' になります (識別子はバッククォートで囲まれ、値は文字列リテラルとして引用されます) 。
  • 比較演算子 (!=><>=<=<>) を指定すると、比較として扱われます。パラメータをまたいで指定することも (?a!=2?a>=2) 、URL 内に分割対象となる = がない場合はインラインで記述することもできます (?a<>2?f(x)>3) 。後者では、再構成された name[=value] が完全な SQL 式として解析されます。

http_allow_table_as_file

有効にすると、HTTP インターフェイスは URL パスの最後の部分を、tabletable.format、または table.format.compression 形式のテーブル名として認識します。このパスは SELECT * FROM table として解釈されます。 http_allow_database_as_path と同様に、これはユーザーごとの設定です。パス形式のリクエストのルーティングは、サーバーレベルの http_allow_path_requests 設定によってグローバルに制御されます (ルーティングは認証前に行われます) 。

http_connection_timeout

HTTP 接続のタイムアウト時間 (秒) 。 設定可能な値:
  • 任意の正の整数。
  • 0 - 無効 (タイムアウトなし) 。

http_make_head_request

http_make_head_request 設定を有効にすると、HTTP からデータを読み取る際に HEAD リクエストを実行し、読み取るファイルのサイズなどの情報を取得できます。この設定はデフォルトで有効になっているため、サーバーが HEAD リクエストをサポートしていない場合は、無効にすることをおすすめします。

http_native_compression_disable_checksumming_on_decompress

クライアントから送信される HTTP POST データの解凍時に、チェックサム検証を有効または無効にします。ClickHouse ネイティブ圧縮フォーマットでのみ使用され (gzipdeflate では使用されません) 、ます。 詳細については、HTTP インターフェイスの説明を参照してください。 設定可能な値:
  • 0 — 無効。
  • 1 — 有効。

http_receive_timeout

HTTP受信タイムアウト (単位: 秒) 。 設定可能な値:
  • 任意の正の整数 (秒) 。0 は無限タイムアウトではなく、接続確立に失敗する可能性があります (POSIXソケットのタイムアウトには正のintervalが必要です) 。

http_send_timeout

HTTP 送信タイムアウト (秒) 。 設定可能な値:
  • 任意の正の整数 (秒) 。0無限タイムアウトではなく、接続確立に失敗する可能性があります (POSIX ソケットタイムアウトには正の間隔が必要です) 。
これはデフォルトプロファイルにのみ適用されます。変更を反映するにはサーバーの再起動が必要です。

http_skip_not_found_url_for_globs

HTTP_NOT_FOUND エラーが発生した glob の URL をスキップします

http_wait_end_of_query

サーバー側のHTTPレスポンスバッファリングを有効にします。

http_write_exception_in_output_format

有効な出力を生成できるよう、例外を出力フォーマットに従って書き込みます。JSON および XML フォーマットで動作します。

http_zlib_compression_level

enable_http_compression = 1 の場合に、HTTPリクエストへのレスポンスで使用するデータの圧縮レベルを設定します。 設定可能な値: 1 から 12 までの数値。9 を超えるレベルを使用するには、libdeflate を含むデフォルトビルドが必要です。libdeflate を含まないビルドでサポートされるのは、レベル 1 から 9 です。
最終更新日 2026年8月18日