http_* セッション設定

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

有効にすると、HTTPインターフェイスはURLパス内の/database/部分を認識し、これを現在のデータベースとして使用します。

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

有効にすると、HTTP インターフェイスはパス内の /name=value/ 部分 (Hive パーティション化スタイル) を認識し、AND で結合したフィルターに変換します。演算子 >、<、>=、<=、!=、<> も認識されます。

http_allow_database_as_path と同様に、これはユーザーごとの設定です。パス形式のリクエストのルーティングは、サーバーレベルの http_allow_path_requests 設定によってグローバルに制御されます (ルーティングは認証前に行われます) 。

有効にすると、既知のパラメータ、設定、param_* プレフィックスのいずれにも該当しない URL パラメータはすべてフィルターとして扱われ、AND で結合されます。次の 2 つの形式を使用できます。

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

有効にすると、HTTP インターフェイスは URL パスの最後の部分を、table、table.format、または table.format.compression 形式のテーブル名として認識します。このパスは SELECT * FROM table として解釈されます。

http_allow_database_as_path と同様に、これはユーザーごとの設定です。パス形式のリクエストのルーティングは、サーバーレベルの http_allow_path_requests 設定によってグローバルに制御されます (ルーティングは認証前に行われます) 。

HTTP 接続のタイムアウト時間 (秒) 。

設定可能な値:

• 任意の正の整数。
• 0 - 無効 (タイムアウトなし) 。

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

クライアントから送信される HTTP POST データの解凍時に、チェックサム検証を有効または無効にします。ClickHouse ネイティブ圧縮フォーマットでのみ使用され (gzip や deflate では使用されません) 、ます。

詳細については、HTTP インターフェイスの説明を参照してください。

設定可能な値:

• 0 — 無効。
• 1 — 有効。

HTTP受信タイムアウト (単位: 秒) 。

設定可能な値:

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

HTTP 送信タイムアウト (秒) 。

設定可能な値:

• 任意の正の整数 (秒) 。0 は無限タイムアウトではなく、接続確立に失敗する可能性があります (POSIX ソケットタイムアウトには正の間隔が必要です) 。

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

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

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

enable_http_compression = 1 の場合に、HTTPリクエストへのレスポンスで使用するデータの圧縮レベルを設定します。

設定可能な値: 1 から 12 までの数値。9 を超えるレベルを使用するには、libdeflate を含むデフォルトビルドが必要です。libdeflate を含まないビルドでサポートされるのは、レベル 1 から 9 です。