s3_* セッション設定

これらの設定は system.settings で確認でき、ソースコード から自動生成されています。 アップロードが正常に完了したことを確認するため、S3 にアップロードされた各オブジェクトを HEAD リクエストで確認します S3 ディスクのホストへの接続タイムアウト。 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 回目以降) 。

詳細はこちらを参照してください。 ファイルを S3 に送信する際にチェックサムを計算しません。これにより、ファイルに対する過剰な処理パスを避け、書き込みを高速化できます。MergeTree テーブルのデータはどうせ ClickHouse 側でチェックサムが計算されるため、通常は問題ありません。また、S3 へのアクセスに HTTPS を使用している場合は、ネットワーク経由での転送中の整合性は TLS レイヤーですでに確保されます。ただし、S3 で追加のチェックサムを使用すると、多層防御になります。 特定のキーの読み込み時に、ファイルが存在しない場合はその不在を無視します。 設定可能な値:

• 1 — SELECT は空の結果を返します。
• 0 — SELECT は例外をスローします。

ListObject リクエストで一度に返されるファイルの最大数 S3 へのマルチパートアップロード時にアップロードする各パートの最小サイズです。 glob による一覧取得の代わりにファイルの反復処理で使用するため、クエリフィルターから抽出できる _path 値の最大数です。 0 は無効を意味します。 S3 との間でデータを送受信する際のアイドルタイムアウトです。1 回の TCP read または write 呼び出しがこの時間以上ブロックされると、失敗します。 S3 エンジンテーブルで、空のファイルをスキップする機能を有効または無効にします。 設定可能な値:

• 0 — 空のファイルが要求されたフォーマットと互換性がない場合、SELECT は例外をスローします。
• 1 — 空のファイルに対して、SELECT は空の結果を返します。

true に設定すると、同じバックアップ用エンドポイントへの S3 リクエストを実行しているすべてのスレッドは、 いずれか 1 つの S3 リクエストでソケットタイムアウトなどの再試行可能なネットワークエラーが発生した後、 すべて速度が抑制されます。 false に設定すると、各スレッドは他のスレッドとは独立して S3 リクエストのバックオフを処理します。 S3 への マルチパートアップロード 時にアップロードする パート の厳密なサイズです (実装によっては、可変サイズの パート をサポートしていません) 。 ListObjects リクエストで一致するファイルが1つもない場合、エラーを発生させます S3 エンジンテーブルで、INSERT 前に truncate するかどうかを有効または無効にします。無効な場合、S3 オブジェクト がすでに存在していると、INSERT を試行した際に例外がスローされます。 設定可能な値:

• 0 — INSERT クエリは新しいファイルを作成します。ファイルがすでに存在し、s3_create_new_file_on_insert が設定されていない場合は失敗します。
• 1 — INSERT クエリは、ファイルの既存の内容を新しいデータで置き換えます。

詳しくはこちらを参照してください。 S3エンドポイントのスタイルを強制します。設定可能な値: auto、virtual_hosted、path。 true に設定すると、すべての S3 リクエストで、最初の 2 回の試行は短い送信／受信タイムアウトで実行されます。 false に設定すると、すべての試行が同一のタイムアウトで実行されます。