> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# http_* セッション設定

> http_* の自動生成グループに含まれる ClickHouse のセッション設定。

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["バージョン", "デフォルト値", "コメント"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        バージョン履歴
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>型</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>デフォルト値</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          再起動せずに変更可能
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

これらの設定は [system.settings](/ja/reference/system-tables/settings) で利用でき、[ソースコード](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。

<div id="http_allow_database_as_path">
  ## http\_allow\_database\_as\_path
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "HTTPリクエストのURLパス内のデータベース名を認識するための新しい設定。"}]}]} />

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

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

<div id="http_allow_filters_as_path">
  ## http\_allow\_filters\_as\_path
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "HTTP リクエストの URL パス内にある Hive スタイルの `name=value` フィルターを認識するための新しい設定。"}]}]} />

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

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

<div id="http_allow_filters_as_unrecognized_url_parameters">
  ## http\_allow\_filters\_as\_unrecognized\_url\_parameters
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "認識されない URL パラメータを HTTP リクエストのフィルター式として扱うための新しい設定。"}]}]} />

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

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

<div id="http_allow_table_as_file">
  ## http\_allow\_table\_as\_file
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "HTTP リクエストの URL パス内のテーブル名を、任意のフォーマット\/圧縮拡張子付きで認識するための新しい設定。"}]}]} />

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

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

<div id="http_connection_timeout">
  ## http\_connection\_timeout
</div>

<SettingsInfoBlock type="Seconds" default_value="1" />

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

設定可能な値:

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

<div id="http_make_head_request">
  ## http\_make\_head\_request
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="http_native_compression_disable_checksumming_on_decompress">
  ## http\_native\_compression\_disable\_checksumming\_on\_decompress
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

詳細については、[HTTP インターフェイスの説明](/ja/concepts/features/interfaces/http)を参照してください。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

<div id="http_receive_timeout">
  ## http\_receive\_timeout
</div>

<SettingsInfoBlock type="Seconds" default_value="30" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "23.6"},{"label": "30"},{"label": "http_send_timeoutを参照してください。"}]}]} />

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

設定可能な値:

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

<div id="http_send_timeout">
  ## http\_send\_timeout
</div>

<SettingsInfoBlock type="Seconds" default_value="30" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "23.6"},{"label": "30"},{"label": "3 分は長すぎるように思われます。これはアップロード処理全体ではなく、単一のネットワーク書き込み呼び出しに対するタイムアウトである点に注意してください。"}]}]} />

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

設定可能な値:

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

<Note>
  これはデフォルトプロファイルにのみ適用されます。変更を反映するにはサーバーの再起動が必要です。
</Note>

<div id="http_skip_not_found_url_for_globs">
  ## http\_skip\_not\_found\_url\_for\_globs
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

HTTP\_NOT\_FOUND エラーが発生した glob の URL をスキップします

<div id="http_wait_end_of_query">
  ## http\_wait\_end\_of\_query
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="http_write_exception_in_output_format">
  ## http\_write\_exception\_in\_output\_format
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "0"},{"label": "フォーマット間の一貫性を保つために変更"}]}, {"id": "row-2","items": [{"label": "23.9"},{"label": "1"},{"label": "HTTP streaming で例外発生時に有効な JSON\/XML を出力。"}]}]} />

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

<div id="http_zlib_compression_level">
  ## http\_zlib\_compression\_level
</div>

<SettingsInfoBlock type="Int64" default_value="3" />

[enable\_http\_compression = 1](/ja/reference/settings/session-settings/enable#enable_http_compression) の場合に、HTTPリクエストへのレスポンスで使用するデータの圧縮レベルを設定します。

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