Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

s3_validate_* session settings

These settings are available in system.settings and are autogenerated from source.

s3_validate_etag_on_read

Type
Bool
Default
1
Version history
VersionDefault valueComment
26.71New setting to detect concurrent in-place overwrites of S3/GCS objects during a read by validating the GET response ETag against the listed one. previous_value=false so `compatibility` with versions before 26.7 restores the pre-existing behavior (no validation).

When reading an object from S3 (or an S3-compatible store such as GCS), check that every GET request returns the same ETag that was observed when the object was listed. A single file read issues many ranged GET requests; if the object is overwritten in place between them (for example by an external writer rewriting a fixed key), the reads can otherwise be stitched together from two different object generations and surface as a corrupted checksum or parse error. When a mismatch is detected the read fails with S3_OBJECT_CHANGED_DURING_READ instead of returning inconsistent data. Disable only for workloads that intentionally read objects that are being overwritten and can tolerate inconsistent reads.

s3_validate_request_settings

Type
Bool
Default
1
Version history
VersionDefault valueComment
24.61Allow to disable S3 request settings validation

Enables s3 request settings validation. Possible values:

  • 1 — validate settings.
  • 0 — do not validate settings.
Navigation