> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# s3_* セッション設定
> s3_* の生成グループに含まれる ClickHouse のセッション設定。
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
型
{type}
デフォルト値
{default_value}
{changeable_without_restart &&
再起動せずに変更可能
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
これらの設定は [system.settings](/docs/ja/reference/system-tables/settings) で確認でき、[ソースコード](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。
## s3\_check\_objects\_after\_upload
アップロードが正常に完了したことを確認するため、S3 にアップロードされた各オブジェクトを HEAD リクエストで確認します
## s3\_connect\_timeout\_ms
S3 ディスクのホストへの接続タイムアウト。
## s3\_create\_new\_file\_on\_insert
S3エンジンテーブルで、各 insert ごとに新しいファイルを作成するかどうかを有効または無効にします。有効にすると、insert のたびに、次のようなパターンでキー付きの新しい S3 オブジェクトが作成されます。
initial: `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz`, など。
設定可能な値:
* 0 — `INSERT` クエリは新しいファイルを作成します。ファイルがすでに存在し、s3\_truncate\_on\_insert が設定されていない場合は失敗します。
* 1 — `INSERT` クエリは、s3\_truncate\_on\_insert が設定されていない場合、各 insert ごとに接尾辞を使用して新しいファイルを作成します (2 回目以降) 。
詳細は[こちら](/docs/ja/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data)を参照してください。
## s3\_disable\_checksum
ファイルを S3 に送信する際にチェックサムを計算しません。これにより、ファイルに対する過剰な処理パスを避け、書き込みを高速化できます。MergeTree テーブルのデータはどうせ ClickHouse 側でチェックサムが計算されるため、通常は問題ありません。また、S3 へのアクセスに HTTPS を使用している場合は、ネットワーク経由での転送中の整合性は TLS レイヤーですでに確保されます。ただし、S3 で追加のチェックサムを使用すると、多層防御になります。
## s3\_ignore\_file\_doesnt\_exist
特定のキーの読み込み時に、ファイルが存在しない場合はその不在を無視します。
設定可能な値:
* 1 — `SELECT` は空の結果を返します。
* 0 — `SELECT` は例外をスローします。
## s3\_list\_object\_keys\_size
ListObject リクエストで一度に返されるファイルの最大数
## s3\_min\_upload\_part\_size
S3 へのマルチパートアップロード時にアップロードする各パートの最小サイズです。
## s3\_path\_filter\_limit
glob による一覧取得の代わりにファイルの反復処理で使用するため、クエリフィルターから抽出できる `_path` 値の最大数です。
0 は無効を意味します。
## s3\_request\_timeout\_ms
S3 との間でデータを送受信する際のアイドルタイムアウトです。1 回の TCP read または write 呼び出しがこの時間以上ブロックされると、失敗します。
## s3\_skip\_empty\_files
[S3](/docs/ja/reference/engines/table-engines/integrations/s3) エンジンテーブルで、空のファイルをスキップする機能を有効または無効にします。
設定可能な値:
* 0 — 空のファイルが要求されたフォーマットと互換性がない場合、`SELECT` は例外をスローします。
* 1 — 空のファイルに対して、`SELECT` は空の結果を返します。
## s3\_slow\_all\_threads\_after\_network\_error
`true` に設定すると、同じバックアップ用エンドポイントへの S3 リクエストを実行しているすべてのスレッドは、
いずれか 1 つの S3 リクエストでソケットタイムアウトなどの再試行可能なネットワークエラーが発生した後、
すべて速度が抑制されます。
`false` に設定すると、各スレッドは他のスレッドとは独立して S3 リクエストのバックオフを処理します。
## s3\_strict\_upload\_part\_size
S3 への マルチパートアップロード 時にアップロードする パート の厳密なサイズです (実装によっては、可変サイズの パート をサポートしていません) 。
## s3\_throw\_on\_zero\_files\_match
ListObjects リクエストで一致するファイルが1つもない場合、エラーを発生させます
## s3\_truncate\_on\_insert
S3 エンジンテーブルで、INSERT 前に truncate するかどうかを有効または無効にします。無効な場合、S3 オブジェクト がすでに存在していると、INSERT を試行した際に例外がスローされます。
設定可能な値:
* 0 — `INSERT` クエリは新しいファイルを作成します。ファイルがすでに存在し、s3\_create\_new\_file\_on\_insert が設定されていない場合は失敗します。
* 1 — `INSERT` クエリは、ファイルの既存の内容を新しいデータで置き換えます。
詳しくは[こちら](/docs/ja/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data)を参照してください。
## s3\_uri\_style
S3エンドポイントのスタイルを強制します。設定可能な値: auto、virtual\_hosted、path。
## s3\_use\_adaptive\_timeouts
`true` に設定すると、すべての S3 リクエストで、最初の 2 回の試行は短い送信／受信タイムアウトで実行されます。
`false` に設定すると、すべての試行が同一のタイムアウトで実行されます。